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SHOWS FOR ARCHIMEDES USERS 


As highlighted in our News pages, there will 
be a BBC Acom User Show again this year, in 
early September. After last year’s foray to the 
hill-top site of Alexandra Palace, the show 
moves back into central London, to the New 
Horticultural Hall, Westminster. 


Old hands will remember this venue well as 
the location for the one-time regular Micro 
User Shows organised by Database 
Publications. Those heady times, when BBC 
micro owners could look forward to at least 
three shows a year (and that was just in 
London) dedicated to their machines, seem 
now to have passed for good. 


We understand that Acorn will have a strong 
presence at this show, and with good advance 
publicity let us hope that the show will be 
well supported both by software houses and 
other suppliers in the Acorn field, and of 
course by the public. After its absence in 
1988, it is important for the Acorn User Show 
to re-establish itself in the calendar, preferably 
at a regular date and location (what are 
readers views on this?). 


Any show, particularly one built around a 
single manufacturer's products, should act as 
a showcase for all that is best in that area. In 
recent years, Acorn-related shows have, 
perhaps, been seen as favouring too strongly 
the already committed BBC micro and 
Archimedes owner at the expense of the 
public at large. An excellent show, with the 
right publicity, could do much to encourage 
others to join the Acorn fold, and that would 
be to the benefit of all Archimedes owners, as 
the larger the market becomes, the better 
supported it is likely to be. 


The show scene has always been a somewhat 
volatile one. Shows start small, grow to 
become successful, and then often decline. 
Perhaps the formula on which success was 
based no longer suits a changing market. At 
one time Compec was the major show in the 
computing calendar, then the PCW Show 
(renamed last year as the PC Show) grew to 
prominence, yet there were many criticisms of 
that show last year 


The latest player in this arena is the 
Computer Shopper Show, not specific to one 
machine, but aimed more strongly than some 
shows at the home user market. So 
successful was that show last December, that 
at times the organisers had to put out 
appeals on local radio for people NOT to 
attend, in view of the very large number of 
visitors already packed into Alexandra Palace. 
As a result, a second Computer Shopper 
Show is scheduled for December of this year, 
but at a new location, the Wembley 
Conference Centre. 


If this is the future, then it is also the past, as 
a magazine called Your Computer at one time 
organised very successful pre-Christmas shows 
for the home user (at Earls Court if | 
remember correctly). However, such shows 
will only amount to major centres of interest 
for Archimedes users if there is a strong focal 
point. And for us that focal point has to be 
‘Acorn. It is therefore very welcome news that 
Acorn has already booked its stand at this 
show, as where Acorn lead others will follow, 
and that includes BEEBUG. 
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SHOW TIME 


Good news for all Acorn enthusiasts is that 
the BBC Acorn User Show will take place 
once again in 1990. Owing to the high cost 
of hiring a hall at Alexandra Palace, the 
venue this year will be the Westminster 
Exhibition Centre (Royal Horticultural 
Hall), and the show will take place on the 
7th-9th September 1990. BEEBUG and 
RISC User will, of course, be exhibiting at 
the show, and can be found on Stand 74. 
The organisers, Safesell Exhibitions and 
Redwood Publishing, are expecting all the 
major companies in the Acorn market to be 
there, as well as many smaller firms. 


Later in the year the Computer Shopper 
Show will be held again. This takes place on 
6th-9th December 1990 at the Wembley 
Conference Centre, and you will find 
BEEBUG on Stand J25. So put these two 
dates in your diary now. 


COLOUR SCANNER 


Clares will shortly be releasing an A4 flat- 
bed full colour scanner for the Archimedes. 
Maximum resolution will be 400 d.p.i., and 
the scanner will work in monochrome using 
a grey scale, or 24-bit full colour. A 
Centronics interface card will be supplied, 
which will offer a significant increase in 
speed over a serial link. Results obtained 
with the scanner are claimed to be 
extremely impressive. 


ORGANISING KNOWLEDGE 


Also from Clares, Knowledge Organiser is 
now available, at a price of £59.95 inc. VAT. 
This is a new enhanced version of ArcTFS, a 
free form database which allows filing of 
data that does not readily conform to the 
constraints of a normal database, and 
subsequent access by keywords. It accepts 
‘data in the form of text files from Graphic 
Writer or First Word Plus, any ASCII file, or 
data directly ported from the Z88 or 
downloaded from online databases such as 
Prestel. 


Clares Micro Supplies can be contacted at 
98 Middlewich Road, Northwich, Cheshire, 
tel. (0606) 48511. 
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STAR AND QUME AT BEEBUG 


BEEBUG has now been appointed as a 
Qume premier dealer. Qume is a well- 
known name in the field of printers, and 
one of its models, the Qume Crystalprint 
Publisher, was reviewed in the last issue of 
RISC User. 


Another printer manufacturer, Star, has 
also recently appointed BEEBUG as a 
dealer. Star manufactures a range of 
popular printers which have generally been 
favourably received by BBC and 
Archimedes users, such as the LC-10 Colour 
and the LC24-10, as well as the latest high- 
performance model, the XB24. 


ARTWORK 


Two discs of artwork suitable for use with 
DTP packages and other software which 
makes use of Draw and Paint files, have 
been released by G. A. Herdman. 
DTP_Images1 contains a wide selection of 
line drawings created with Draw, pixel- 
based images of UK and world maps created 
with Paint, and a number of digitised video 
images. DTP_Images2 contains Paint files on 
such subjects as places, animals, aircraft, 
motors etc. Each disc costs £8.99 (no VAT), 
and both discs are available together at the 
special price of £14.99, For details of these 
and other educational items, contact 
G.A.Herdman Educational Software, 43 
Saint Johns Drive, Clarborough, Retford 
DN22 9NN, tel. (0777) 700918. 


CRAFTY PROGRAMMING 


Two program discs designed for use in craft 
education have been released by 4Mation. 
Craftshop 1 contains applications for 
creating complex designs using repeated 
patterns, and 2D and 3D stitching designs 
which can be rotated in various planes to 
create mobiles. With Craftshop 2, 
embroidered designs can be created by 
combining stitches, and tiling patterns can 
be designed by repeating simple or complex 
tile outlines and decorating them by using 
Paint. All Craftshop designs may be saved 
as sprites, allowing them to be imported 
into other packages. 
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A pattern design created with Craftshop 1 


Each disc costs £33.35 inc, VAT. A free 
demonstration disc is available on receipt of 
a blank disc and an SAE. Some sample 
screens from this are included on this 
month’s RISC User magazine disc. For 
more details on Craftshop contact 4Mation 
Educational Resources, Linden Lea, Rock 
Park, Barnstaple, Devon EX32 9AQ, tel. 
(0271) 45566. 


PIPEDRIVERS AND FONTS 


Ian Copestake Software has announced a 
range of software designed as extensions to 
Pipedream. PipeDriver Dot 1 costs £11.50 
inc. VAT and is a printer driver specific to 
Pipedream, allowing access to many of the 
features found on modern printers, such as 
proportional spacing, resident fonts, etc. 
PipeDriver Symbol Sets provide foreign 
language and scientific symbols for word- 
processing, which appear on screen exactly 
as they will be printed. The list of sets 
includes Maths/Physics, Greek, Forms 
Design, and various languages, and each 
set costs £21.85 inc. VAT for dot-matrix, or 
£33.35 inc. VAT for laser (non-Postscript). 
Finally, PipeDriver Typefaces lets you vary 
the style of your printed work. A set of 
three typefaces for laser (non-PS) or 24-pin 
printers costs £33.35 inc. VAT, and a set of 
seven for the Star LC-10 is available at the 
same price. 
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Also announced by the same publisher is a 
wide range of outline fonts. For a limited 
period there will be a special promotional 
price: fonts will cost from £2.30 inc. VAT 
each, depending on how many are 
purchased. For further details on any of 
these products contact Ian Copestake 
Software, 10 Frost Drive, Wirral, 
Merseyside L61 4XL, tel. 051-648 6287. 


AN ARMFUL OF OLD FAVOURITES... 


Computer Concepts has converted several 
of its most popular BBC ROMs to ARM 
code. Wordwise A-Plus, a new ARM version 
of one of the most successful word 
processors for the BBC, runs from the 
Desktop but is not multi-tasking. It has all 
the features of the original, and maintains 
file compatibility with earlier versions of 
Wordwise and Wordwise Plus. In addition, 
more free memory is available, and the 
program now runs much faster. Wordwise 
A-Plus costs £33.35 inc. VAT. Existing WW 
or WW+ owners can upgrade for £17.25 inc. 
VAT. 


Spell-Master and Inter-Sheet have also 
been rewritten to run on the ARM. Both are 
available on disc at £33.35 inc. VAT, and 
Spell-Master is also available as a ROM 
(requires ROM podule), at £49.00 inc. VAT. 


.. AND SOME NEW ONES 


Computer Concepts is also planning to 
release two completely new packages 
around Easter. Desktop II will replace the 
Acorn desktop filer and will provide 
significant new features. It will also allow 
icons to be placed anywhere on the 
Desktop, giving simpler access to 
regularly used files and directories. 
FastDraw is a drawing package 
functionally similar to Acorn’s Draw, but 


» faster and ten times smaller, making it 


easier for owners of 1Mbyte machines to 
use it in conjunction with other software, 
e.g. a DTP program. 


Computer Concepts is at Gaddesden Place, 
Hemel Hempstead, Herts HP2 6EX, tel. 
(0442) 63933. AU 
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DABS PRESS SPRING SELECTION 


ARCHIMEDES FIRST STEPS 
Beginners Guide to the 
Archimedes & BBC A3000 


This book is the perfect introductory guide to the 
Archimedes, to guide you through the first few months of 
ownership, acting as an easy-to-read supplement to the 
User Guide. 

The book describes in detail how to put the RISC OS Desk- 
top to best use. The Welcome discs contain a wide range of 
useful programs, and these are fully documented. 

But the book also goes beyond this and describes the sort of 


software and hardware additions available to the 
Archimedes owner, and how to choose and install them. 


The many features of this book include: 
* Applicable to all Archinedes with RISC OS 
* Using the Desktop, RAMdisc and ADFS 
* Edit, Paint, Draw and Maestro 
* The Task Manager 
* The BBC and PC emulators 
¢ Hardware and software additions 
* Illustrated throughout 
AVAILABLE NOW! 


PRICE £9.95 
YET ANOTHER POPULAR DABHAND GUIDE 


BASIC V 


A Dabhand MiniGuide 


This book provides a practical guide to programming in 
BASIC V. Assuming a familiarity with BBC BASIC in 
general, it describes the many new commands offered by 
BASIC V, already acclaimed as one of the best and most 
structured versions of the language on any micro. The 
book is illustrated with a wealth of easy-to-follow ex- 


amples. Major topics covered include: 


* Using thecolour palette ¢ WHILE, IFand CASE ¢ Use of 
the mouse and pointer * Local error handling * Operators 
and string handling * The Assembler * Control structures 
* Matrix operations * Functions and procedures * Ex- 
tended graphics commands * Sound 


Only £9.95 


FULL ARC CATALOGUE FREE ON REQUEST 


All products available from your local dealer, or Dabs Press (Dept. RUA), 
5 Victoria Lane, Whitefield, Manchester M25 6AL. Tel. 061-766 8423. Fax. 
061-766 8425. Prices include VAT and UK postage. Foreign deduct VAT, 
but add £2.50 (surface/Europe), £12 (air). Payment by cheque, Access/MC 
or Visa, or official order. Trade enquiries welcome. 


eocce 
SEE US AT THE 
@ COMPUTER CASH 'N' CARRY « 


° GMEX - MANCHESTER . 
15-18 MARCH 1990 C= 
eeccccscovescece 
Cambridge Pascal 
isacomprehensive 
version of the Pas- 
cal language and 
includes many ex- 
tra enhancing fea- 
tures over the stan- 
dard specification 
including full dy- 
namic string han- 
dling, local error 
handling, random 
access files, direct 
access to ‘star’ com- 
mands and RISC 
OS SWI calls. It is 
100% Desktop 
compatible but can 
also be run from the command line. All programs compile 
into fast, efficient machine code. 
Cambridge Pascal requires any Archimedes running RISC 
OS with at least IMb of RAM. Hard discs and extra 
memory are useful, but the system is perfectly workable 
with this minimum configuration. 
Price £79.95 (£69.52+VAT). Site licences available. Free 
demonstration disc and full specification sheet available 
on request. 


DEMO DISC FREE ON REQUEST 


CAMBRIDGE 
PASCAL 


Full featured Pascal Compiler for the Acorn 
‘Archimedes 


from 

Trinity Concepts 
Authors of the 
Z88 Operating 
System 


Beyond the User Guide, this comprehensive guide is in- 
dispensable for anyone wanting to get the most out of 
their Z88. 

The use of PipeDream, and the other built-in programs is 
clearly explained with easy-to-follow examples,and many 
hints and tipsen route, including much previously unpub- 
lished information. No previous knowledge is required. 
Trinity Concepts are the partnership who designed the 
Cambridge Z88 Operating System software, and much of 
the applications software. Their understanding of the way 
the Z88 works is second to none. 


Only £14.95 all inclusive 
300 PAGES OF INFORMATION 


Using Draw Files in Basic _— 


by Mike Summerton 


Ws purpose of this article is to show 
how Draw files, created with the Draw 
application or by other means, can be 
accessed and used to recreate the original 
images from within Basic programs. To 
reproduce Draw objects, a basic library of 
routines for re-drawing pictures is 
developed. This library will later be 
expanded to allow the drawing and 
manipulation of other types of object. Two 
short programs, which use the library, are 
also described, the first of which takes 
some of the contents of a Draw file and 
draws them on screen, and the second 
lists all the objects contained in a Draw 
file. 


Group Object 


Object 
Object 


Group 
Path 
Path Object 
Path Object 
Path 
Path Object 
Path Object 


9 Object type 6 
Object type 2 
Object type 

2 Object type 
Object type 
Object type 
Object type 


Part of the output from the ListAll demo 


Although the Draw application can 
handle other types of object, such as text 
and sprite objects, I shall concentrate in 
this article on the Vector Graphics Objects 
which are at the heart of Draw. The lines 
and curves which can be used to create 
pictures in Draw are stored as collections 
of X,Y co-ordinates with a code describing 
how the points should be joined. These are 
the objects known as Vector Graphics 
Objects (VGOs). 


The beauty of these objects is that they 
require very little storage space, and 


hence are quick to both load and save. 
Another very important advantage of 
VGOs is that because they are stored as 
collections of co-ordinates, they can be 
scaled, moved and rotated without 
distortion, and can be printed such that 
they are very true to the screen image. 


Simple images are easy to create using 
Draw, and more complex images can be 
created with practice. There are a number 
of applications, such as Pipedream and 
the flurry of Desktop Publishers now 
appearing, which can use images created 
by Draw. However, there is no easy way of 
re-displaying Draw files on screen from 
your own programs in the same way that 
simple star commands can be used to 
draw system sprites. 


THE DRAW LIBRARY 

The DrawLib library routines given 
here (see Listing 1) are sufficient to allow 
some of the more common operations on 
Draw files. The library routines are 
grouped together according to the type of 
object they are used to manipulate. Note 
that PROCObjMod_Setup must be called 
once before any of the other routines can 
be used. A Draw file is loaded into 
workspace claimed from the RMA rather 
than into a byte array, in order to avoid 
problems redimensioning arrays when re- 
using the routines. The format of the 
data in the Draw file, and the form of 
data required by the Draw primitives, 
makes it easier and more efficient to use 
pointers into the loaded file to identify 
objects and data, rather than put the 
objects and data into Basic variables or 
arrays. The REM statements help to 
structure the library, but may be omitted 
to save time. 


The procedures and functions 
contained in this library at present are as 
follows: 
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PROCObjMod Setup Set Wimp colours 

Set Cap and Join blocks 

Set transformation matrix 

Set conversion factor 
FNBuf_Create Buffer Management 
PROCBuf_Enlarge Enlarge specified buffer 
PROCBuf_ Scrap Return buffer to RMA 
FNFile_Load Load a Draw file 
PROCObj_Next Move to next object 
PROCObj_Display Display object 

(type2 only at present) 
PROCObj_Info Display object type 
FNArea_Overlap Check for overlap 
PROCPath Display Display Path object 


PROCPath_GetDetails Get object details 


The Draw library should be type in and 
saved under the name DrawLib. The copy 
of the library on the magazine disc 
contains an additional procedure, 
PROCDrawLib_Help which can be called 
to display help on the Draw library. 


USING THE DRAW LIBRARY 

Two short programs are listed to 
demonstrate the use of the Draw library, 
and you should enter these as the basis for 
a better understanding of the library 
routines. DrawPaths (Listing 2) draws all 
the Path objects in any Draw file. ListAll 
(Listing 3) lists all the objects in a Draw 
file. Both programs have some features in 
common. The system variable 
RUDraw$Dir is set to the directory 
containing the Draw library, the two demo 
programs, and any sample Draw files - the 
programs assume a Draw file called 
‘drawfile’ but this can be easily changed to 
suit your own requirements (see line 60 in 
each case). 


This directory must also contain the 
Colours module (from the !System folder 
on Applications dise 1), and Palette (by 
selecting the palette icon on the icon bar) 
in order to ensure that the Wimp colours 
are correctly reproduced in the current 
mode. The Draw library is loaded by each 
demo program using Basic’s LIBRARY 
command. Alternatively the routines 


could be appended to the end of each 
program. To do this load DrawLib and 
type: 
*SPOOL LibSpool 
LIST 
*SPOOL 
Then load a demo program, and type: 
*EXEC LibSpool 
before resaving the demo. 


I hope to extend the Draw library next 
month so make sure you keep a copy of 
the original version of the library if you 
choose to change it in any way. In what 
follows we will look in more detail at the 
structure of Draw files and the use of the 
Draw module. 


THE DRAW MODULE 

There is a module called Draw in RISC 
OS which contains SWI calls for handling 
VGOs, and the library routines presented 
here make use of these routines. Acorn 
use the term Path for the particular type 
of VGO that Draw uses, and so I shall use 
this term henceforth. The two main SWI 
calls for manipulating Paths are 
Draw_Stroke and Draw_Fill. They both 
take a Path and output it to the VDU 
screen, changing it in the process if 
required. The difference between them is 
that Draw_Stroke draws only the outlines, 
whereas Draw_Fill fills the area delimited 
by the outline without actually drawing 
the outline. Hence a filled outline requires 
one call to each of these routines, one to 
draw the outline and one to fill it. 


When using these calls, register RO 
points to the Path to be drawn, and the 
other registers hold data which can be 
used to determine how the Path is 
drawn. You need not be too concerned 
about the structure of a Draw Path at 
this stage. The remaining data is 
described in more detail in Table 1 which 
shows the use of registers for calls to 
Draw_Stroke (this and other information 
on the Draw module is fully documented 
in the PRM). 
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of Bytes 
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Data 


Pointer to Path to be drawn. 

Fill style for thick lines (0 for default). 

Pointer to transformation matrix. 

Flatness (0 for default). 

Line thickness (0 for default thin line). 

Pointer to cap and join specification for 

lines (0 if only thin lines used). 

Pointer to dash pattern (0 for continuous line). 


Table 1. Registers used with Draw_Stroke 


Draw_Fill is similar to Draw_Stroke, 
but only registers RO to R83 are used. 
Register R1 holds the fill style for the 
enclosed area rather than for the line 
itself (default 0); the use of the other three 
registers is unchanged. You may be 
wondering how the colour of the line or fill 
is decided upon. This is easy: it is the 
current colour, selected by GCOL. 


It is probably a 


3 Number 
good idea to of Bytes 
experiment with 
each of these 


parameters using 
the Draw applica- 
tion itself in order 
to appreciate their 
effect on the 
resulting image. 
The Transforma- 
tion Matrix is 
specified as a 6 word block which allows 
the Path to be moved, rotated and scaled 


variable Object list. 


Contents of Block 


Object type. 
Size of object block. 


X co-ordinate of bottom left of object bounding box in Draw units. 


Y co-ordinate of bottom left of object bounding box in Draw units. 
X co-ordinate of top right of object bounding box in Draw units. 
Y co-ordinate of top right of object bounding box in. Draw units. 
Object description block. 


Table 3. The structure of a Draw object 


prior to drawing it. Flatness is a word 
defining the degree of precision to be used 
when plotting Bezier curves (which are 


RISC User April 1990 


constructed from short lines). Caps are 
placed at the start and end of Paths, and 
their shape can be varied if the line is 
thick enough for it to make a difference 
(butt, round, projecting square, or 
triangle). The Join specification affects 
the shape of joints between lines within a 
Path (mitred, rounded, or bevelled). The 
Dash Pattern describes the pattern to be 
used when drawing the lines within a Path. 


DRAW FILE STRUCTURE 

The format of a Draw file is shown in 
Table 2. Four different systems of units 
are used in Draw files in order to gain 
maximum precision in a word. A Draw 
unit is a value which is 1/256th of an OS 
unit (itself 1/180th of an inch) and so 
Draw units can be converted to OS units 
by shifting the word right 8 times. 


Contents of File 


File type identifier padded with zeros. 

Application identifier padded with spaces and zero terminated. 

X co-ordinate of bottom left of document bounding box in Draw units. 
Y co-ordinate of bottom left of document bounding box in Draw units. 
X co-ordinate of top right of document bounding box in Draw units. 

Y co-ordinate of top right of document bounding box in Draw units. 


Table 2. The structure of a Draw file 


The first 6 items in a Draw file are 
known collectively as the file header. The 
document bounding box 
gives the size and position of 
a box which will just enclose 
all the objects contained in 
the file. It is used by the 
Wimp system to decide 
whether the box is visible 
within the current window. 
The Object list is the list of 
things to be drawn 
consisting of Paths, Sprites, 
Text etc. 


The structure of an object is shown in 
Table 3. The object type is a number 
normally in the range 0 to 10. Type 2 is a 
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Path. The structure of a Path object is 


shown in Table 4. 


Number 


Contents of Path Description Block 


of Bytes 


4 


variable 


Tai 


fut 


Fill colour in form &RRGGBBOO 
(or -1 if no filling). 

Line colour in form &RRGGBBOO 
(or -1 if transparent line). 

Thickness of line in User units. 

Joints, Caps, Pattern and Winding Rule flags 
(see below). 


Dash pattern if previous word indicates dash 


pattern is to be used (see below). 
Path block ending in path element type 0. 


ble 4. The structure of a Path object 


The Path is in a form that can be 
passed directly to Draw_Stroke or 
Draw_Fill; but unfortunately the rest of 
the information is held in a compacted 
form and needs to be converted before it 
can be passed to these routines. The 
detailed description of the contents of each 
of these words will have to wait for a 


ture article, 


Listing 1 


10 REM >RUDraw.DrawLib 

20 REM RISC User April 1990 
30: 

230 REM *Object Ob3jMod* 
250: 

260 DEF PROCObjMod_Setup 


270 *RMENSURE ColourTrans 0 RMLOAD <RU 


Draw$Dir>. colours 


10 


280 *<RUDraw$Dir>.Palette 

290 REM Set up Cap and Join block 
300 DIM ObjMod_cj% 20 

310: 

320 REM Set up matrix for draw image 
321 REM transformation 

330 DIM ObjMod_mat% 24 

340 !0bjMod_mat %=1<<16 

350 ObjMod_mat$ !4=0<<16 

360 ObjMod_mat%!8=0<<16 

370 ObjMod_mat%!12=1<<16 

380 ObjMod_mat%!16=0<<8 

390 ObjMod_mat% !20=0<<8 


400 
410 
411 
420 
430 
440 
470 


REM Set conversion from internal 
REM draw units to millipoints 
ObjMod_fac=350/256 

ENDPROC 


REM *Object BUFFER* 


490 : 


500 
510 
520 


DEF FNBuf_Create (1%) 
LOCAL £%,p%,n% 
IF 1%MOD4<>0 THEN n¢=(1%DIV4+1) *4 


ELSE nt=1% 


530 
540 
550 
560 
570 
580 
590 
600 
610 
620 
630 
640 
650 
660 
670 
680 
690 
700 
710 
720 
730 
740 
750 
760 
770 


SYS "OS Module",6,,,n% TO ,,p%;£% 
IF (£%AND1)<>FALSE THEN =0 

!ps=1s 

=p 


DEF PROCBuf_Scrap(p%) 
SYS "OS Module", 7, ,p% 
ENDPROC 


DEF PROCBuf Enlarge (RETURN p%, 1%) 
LOCAL n& 
IF p%=0 THEN p%=FNBuf_Create (4) 
n%=FNBuf_Create (1%) 
IF n%<>0 THEN 
PROCBuf_Copy (p%,n%) 
PROCBuf_Scrap(p%) 
pt=n% 
ELSE 
ps=0 
ENDIF 
ENDPROC 


DEF PROCBuf_Copy (p%,n%) 
LOCAL if 
IF!p%>!n% THEN ERROR 101, "ERROR - 


Buffer too small, in Buf_Copy Procedure; 


780 


IF!p%MOD4<>0 THEN ERROR 102, "ERROR 


- Buffer size not a multiple of 4, in B 
uf_Copy Procedure;" 


790 
800 
810 
820 
830 
850 


870 : 


FOR i%=4 TO !p%-1 STEP 4 
nglit=ps!is 

NEXT is 

ENDPROC 


REM *Object FILE* 


RISC User April 1990 


Using Draw Files in Basic 


880 DEF FNFile Load (n$,RETURN b%) 
890 LOCAL t%,1%,e%,n%,r% 
900 SyS"OS File",5,n$ TO r%,,t%,,1% 
910 IF r%=0 THEN PRINT"ERROR - File "; 
n§;" not found.":=0 
920 e%=1%+&400 
930 IF e%>!b% THEN PROCBuf Enlarge (b%, 
e%) 
940 IF b%=0 THEN =0 
950 IF ((t%>>8)AND&FFF)<>&AFF THEN PRI 
NT"ERROR - Wrong type of file.":=0 
960 b%!4=1%:OSCLI ("LOAD "+n$+" "+STRS~ 
(b&+8)) :! (bs+1%+4)=0 
970 =b%+4 
980 : 
1010 REM *Object OBJECT* 
1030 : 
1040 DEF PROCObj Display (b%, a%, p%) 
1050 IF FNArea_ Overlap(a%,b%+8) THEN 
1060 CASE !b% OF 
1070 WHEN 2 : REM a Path 
1080 PROCPath_ Display (b%+24, p%) 
1090 OTHERWISE : REM Do nothing 
1100 ~ENDCASE 
1110 ENDIF 
1120 ENDPROC 
1130 : 
1140 DEF FNOb} Next (£%, p$) 
1150 LOCAL n% 
1160 CASE !p% OF 
1170 WHEN 0 : REM a Font table 
1180 WHILE ?p%<>0:p%+=1:ENDWHILE 
1190 WHILE ?p%=0:p%+=1:ENDWHILE 
1200 =p% 
1210 WHEN 6 : 
1220 = =p%+36 
1230 WHEN 7 : REM tagged 
1240 © =p%+28 
1250 OTHERWISE : 
1260 nt=ps+ps!4 
1270 IF n%>=£%+!£% THEN =0 ELSE 
1280 ENDCASE 
1290 : 
1300 DEF PROCObj_Info (p%) 


REM a group 


ng 


1340 WHEN 2 : PRINT"Object type 2 - Pat 
h Object" 

1350 WHEN 5 : PRINT"Object type 5 - Spr 
ite Object" 

1360 WHEN 6 : PRINT"Object type 6 - Gro 
up Object" 

1370 WHEN 7 : PRINT"Object type 7 - Tag 
Object" 


1380 WHEN 9 : PRINT"Object type 9 - Tex 
t Area Object" 

1390 WHEN 10 : PRINT"Object type 10 - T 
ext Column Object" 

1400 OTHERWISE : PRINT"Unknown Object t 
ype ";p%!0 

1410 ENDCASE 

1420 ENDPROC 

1430: 

1450 REM *Object AREA* 

1470 : 

1480 DEF FNArea_Overlap(a%,b%) 

1490 IF b%!4>a%!12 OR b%!12<a%!4 THEN = 
FALSE 

1500 IF !b%>a$!8 OR b%!8<!a% THEN = FAL 
SE 

1510 =TRUE 

1520 : 

1540 REM *Object PATH* 

1560 : 

1570 DEF PROCPath Display (b%, p%) 

1580 IF p%<>0 THEN 

1590 ORIGIN !p%,p%!4 

1600 ENDIF 

1610 PROCPath_GetDetails (b%) 

1620 IF Path fcol%<>&FFFFFFFF THEN 
1630 SYS"ColourTrans_ SetGCOL",Path_fc 
01%,0,0,0,0 

1640 SYS"Draw Fill", Path_strst%,Path_ 
wind’, ObjMod_mat% 

1650 ENDIF 

1660 IF Path_lcol%<>&FFFFFFFF THEN 

1670 SYS"ColourTrans_SetGCOL", Path_lc 
ols 

1680 SYS"Draw_Stroke", Path_strst%,0,0 
bjMod_mat%,0,Path_thick%, ObjMod_cj%, Path 


1310 CASE p%!0 OF _pat’ 

1320 WHEN 0 : PRINT"Object type 0 - Fon 1690 ENDIF 

t Table" 1700 ENDPROC 

1330 WHEN 1 : PRINT"Object type 1 - Tex 1710 : 

t Object" Contihued on page 52 
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Hypermedia for Archimedes! 


Genesis provides a framework for creating and accessing linked pages of information. 
Many types of data can be displayed on Genesis pages including: 


Q text in many fonts, sizes and colours 

Q sprites from painting packages or digitizers 

Q object oriented graphics from Draw, Presenter 2 and other packages 
Q 3D pictures from Euclid which can be viewed from any position 

Q animated films from Mogul 


Q music from Maestro, including support for MIDI 
NB Genesis does NOT need Euclid, Mogul or Maestro to be running in order to handle their data 


Genesis can be used for creating 
information resources which can be 
updated as appropriate. 


Genesis supports many of the 
requirements of the National 
Curriculum for retrieving, developing 
and organising previously stored 
information as well as amending 
and adding to this information. 


Genesis provides an ideal tool for 
creating reports and presentations 
with hard copy available via the 
standard RISC OS printer drivers. 


Price excl VAT: £86.95 £69.95 (ed) 
Site licence: £347.80 £279.80 (ed 


Broadway House, 149-151 St Neots Road 


S Hardwick, Cambridge CB3 7QJ 
[== |SOLUTIONS/ 0954 211760 Telecom Gold 74: YKK255 


Genesis 


Mike Williams reviews an impressive new software package from 
Software Solutions for generating multi-media information systems. 


vy hen I visited the BETT show back in 
January, one of the products that really 
caught my eye was Genesis, the new 
release from Software Solutions. The 
example applications shown were both 
appealing and impressive, revealing the 
rich potential of this package. But 
what,you may ask,is Genesis? Well that is 
much more difficult to answer. 


UNDERSTANDING GENESIS 


The first and most important point to 
understand is that Genesis is effectively 
an editor for creating an application, but 
not just any application of course. It allows 
the user to create pages containing a 
variety of information including text, 
graphics, animations and music. Pages can 
be similar to each other or individually 
tailored to the user’s requirements. 
Pages can be linked together by a 
variety of both simple and complex 
routes. The end result is effectively a 
multi-media information system. 


The software is aimed strongly at 
the educational market, and it seems 
to have enormous potential there. 
Having tried it out in a modest way, I 
feel sure that many others with a 
whole variety of information handling 
requirements will be intrigued and 
then drawn to Genesis. 


Let me describe one or two of the 


examples supplied as part of the Genesis dump showing frames and links highlighted 


package. First of all, we will double 
click on an application called Europe. This 
installs itself on the icon bar as a multi- 
tasking application and opens a full 
screen window showing a simplified map 
of Europe. The EEC countries are shaded 
in one of two shades of green. Double click 
on any of these countries to bring up 
another window giving the name of the 
country, its population and area, the 
national flag, and the name and location 
of the capital city. 


In some instances (this application is 
deliberately incomplete), double clicking 
on the capital will reveal textual 


information on that city. Two of the 
country displays show a music icon. 
Double clicking on that plays the national 
anthem. And as many windows relating to 
different countries can be displayed and 
moved around as you like (within any 
limits imposed by RISC OS). 


Or take another demonstration 
application, an auto-dial phone system. 
This is set up for tone dialling with 
buttons labelled 0 to 9. Double clicking on 
any button produces an audible tone. The 
application also shows panels labelled 
Emergency and Time - double clicking on 
these will generate the correct tone 
sequence. Other entries are likewise 
labelled. 


Tage PS 


There are three other demonstrations, 
including a highly effective tour of Genesis 
itself. Words fail to do justice to the 
potential these reveal. Clearly much time 
and effort will be required to build an 
application with Genesis, particularly in 
accumulating the resources in the form of 
Draw files, sprites, animations ete which 
are to be marshalled together by the 
Genesis editor. Genesis itself does much to 
make the process as easy as possible. 


USING GENESIS 


Genesis is supplied on two discs, one 
containing the Genesis editor and 
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supporting applications, and one containing 
five demonstration applications created 
with the package. There is a smart, well 
illustrated and well produced manual 
running to just over 90 pages. 


Once Genesis has been installed, 
pressing the Menu button allows the New 
option to be chosen; an application 
directory containing various files is then 
created and a blank page appears, the 
title page for your application. 
Information on the page is controlled by 
frames, which can be repositioned and 
resized as and when required. A page 
menu relates to the page as a whole, while 
a frame menu, which varies according to 
the contents of a frame, controls options 
there. A word frame is used where the 
same text label (like a database field 
name) is to appear on all similar pages; a 
text frame contains text (in a choice of 
styles and sizes selected by the user) 
which varies from one page to the next. 


Population: 53 324 686 
firea (sq ka): 543 255 


Fopat] Exchange rate: 18 
Bae 


Using the 'Europe' example 

So, assume you create a text window 
with a suitable legend (let’s say ‘cat’). Now 
create a new page, with a new frame. 
Locate a suitable sprite with the image of 
a cat (one is supplied with Genesis in its 
GenLib directory) and drag this to the 


empty frame. The image, as with text, can” 


be repositioned and resized. 


Lastly, returning to the original text 
frame on page one, from the frame menu 
select Link to and drag the resulting icon 
and drop it over the image of the cat in 
page two. Now save and close down your 


newly created application. Restart it and 
page one with the legend ‘cat’ appears. 
Double click on this and the picture of the 
cat on its own page springs into life. 


That is a very simple example, but 
should illustrate the relative simplicity 
with which information systems can be 
created using Genesis, with all the detail 
which undoubtedly exists being hidden from 
the user and taken care of automatically. 


As well as text frames, there are five 
other explicit data types recognised by 
Genesis. Graphics in the form of sprites or 
Draw files can be dragged into frames (a 
frame takes on the identity of its 
contents). There are no facilities for 
editing graphics objects within Genesis, it 
being assumed that this is done in Draw, 
Paint or similar. 


Any Maestro music file can be dragged 
into a frame, but unlike pictures, the 
frame is filled with a rescaled image of the 
Maestro icon. Subsequently clicking on 
that icon causes the linked music file to be 
played. 


Two other forms of graphics can be 
used related to the applications Euclid and 
Mogul, both supplied by Ace Computing. 
Euclid allows the creation of 3D graphics 
objects. Once such an object exists it can 
be dragged into a frame in Genesis where 
it can be moved about, rotated, enlarged 
or shrunk by code built into Genesis. You 
also have some control over the lighting 
and subsequent shading of the object. 


Mogul is a separate package from the 
same source used for creating 3D 
animations. Again these can be imported 
into Genesis, with some degree of local 
control. It is really quite impressive to 
have pages simultaneously playing music 
and displaying an animated sequence, 
though the demands on RISC OS are at 
times sufficient to slow things down 
noticeably. 


If any unknown filetype is dragged 
into a Genesis frame, then as with 
Maestro, a rescaled image of the 
corresponding icon fills the frame. 
Subsequently double clicking on that icon 
will have the same effect that it would 
have if the icon were in a directory viewer. 
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For example, if the icon were that of a 
Pipedream document, Pipedream would 
be activated and the linked document 
loaded ready for editing. 


One significant feature of Genesis is 
the use of buttons. A button usually 
performs a linking task of some kind, the 
details of which exist as a separate script 
file. A number of buttons are supplied, for 
example Another. This is placed on the 
last of a set of linked pages. Double 
clicking on that button creates an 
additional page with the same format, the 
button installs itself on the new page, and 
replaces the button on the previous page 
with a new button called Next. 


Script files are very powerful. They 
exist as pure text files which can be 
created and edited directly, though this is 
really for the more experienced Genesis 
user. There are also facilities for creating 
index files for faster access to pages and 
their contents, though this is something 
that has to be created manually, as the 
information system is built. 


OTHER FACILITIES 

Genesis is essentially an editor for 
creating and editing applications. There is 
another application on the Genesis dise 
called Browser. This allows you to 
examine any application in much the 
same way as you can with Genesis itself, 
but you cannot now change the page 
layouts, or the links between pages. 
However, the text in frames can be 
changed, provided that the frame has not 
been locked from within the editor. It is 
claimed that within an educational 
context, this allows applications to be 
created which children can then modify in 
a controlled way, for example by providing 
captions of their own making for pictures 
supplied by the teacher. Modified versions 
can then be saved to provide a 
personalised copy. 


Another element of Genesis is the 
Genesis Filer. This is responsible for the 
handling of pages and data files within an 
application, being installed automatically 
as required. It can also be used directly, 
and helps to speed up some of the processes 
involved in creating an application, making 
links for example between pages. 


Genesis also allows a country file to be 
edited so that menus appear in any one of 
six languages. 


DOCUMENTATION 

In general this is well written, and 
handles the presentation of a wealth of 
detail in an organised manner. It also 
makes good use of two of the examples 
provided to explore many of the features 
of which the software is capable, and it is 
the examples which convince one of the 
value and power of Genesis. 


CONCLUSIONS 

As I have tried to explain, all Draw, 
sprite, Maestro, Euclid and Mogul files 
must be created outside of Genesis. This 
may, of course, involve a great deal of 
work. What Genesis does is to provide the 
means of marshalling such a variety of 
sources in a coherent way. For what it 
does and how it does it I am full of 
admiration. This is the Archimedes really 
showing its potential. 


I do have a couple of niggles. I ran 
Genesis on an A310 with 1 MByte of 
memory and a single disc drive. This 
resulted in much frequent swapping of 
discs at times - a hard disc would clearly 
be beneficial. The rate of refresh of 
windows at times also appeared both slow 
and inefficient. Genesis also contains a 
!System folder, but in its modules 
directory there is a copy of ABCLib 
(presumably from Dabs Press) rather than 
the Acorn supplied CLib. Thus if you 
attempt to install Edit, say, after using 
Genesis, Edit will look in the wrong 
!System folder and fail for want of CLib. 
This really does seem as silly as it is 
annoying. 


However, I am full of enthusiasm for 
this package which appears to offer 
considerable potential and flexibility for a 
quite moderate price, and its even cheaper 
to schools. Highly recommended. 


Product 
Supplier 


Genesis 

Software Solutions 

Broadway House, 

149-151 St Neots Road, 

Hardwick, Cambridge CB3 7QJ. 

Tel. (0954) 211760 

£99.99 inc. VAT. = 
£80.44 inc. VAT to education. Al 


Price 
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GRAPHBOX 


- THE GRAPHICS 


With twenty graph types and its multi-tasking capabilities 
GraphBox is one of the most flexible packages for the 
Archimedes. Enter data through Graph Edit or drag data in from 
any other legal multi-tasking software and produce a graph which 
can then be exported to a wordprocessor or DTP package. 
GraphBox gives you a professional graph in a’matter of minutes, 
whether you require a simple scatter or a more complex polar 
chart. These features plus the ability to enter formulae on the X, Y 
or Z axis and save it to the Acorn Draw or Edit applications make 
GraphBox an impressive data presentation package. 


MULTISTORE 
- THE DATABASE 


A multi-tasking, relational database allowing many database files 
to be opened at one time. Files may be linked so that relationships 
between files are automatically tacked. Rapid searches by any 
criteia, including ‘sounds like’ facility. Key fields for fast search, 
indices to allow file browsing in more than one order without 
‘sorting. Fast sort facility by single field or complex expression, 
Comprehensive reporting facilities allow any report, including 
totalled lists of fields, labels with multi-font capability, line trapping, 
justification, paging, multi-set stationery and even completely 
relational reports. 


master 


Product Year’ 


ATELIER 


~- THE STATE OF THE ART 


An art package in a class of its own, Atelier exploits the 256 colour 
capabilities of the Archimedes. Stunning graphics can be created 
easily and professionally. Atelier is multi-tasking which means your 
pictures or artwork can be exported to a DTP package by simply 
dragging them across. Comprehensive sprite editor, undo brush, 
patterns and definable brushes. Extremely smooth fill routines, 
ability to import digitised images and advanced features which 
allow you to wrap images onto any definable 3D shape coupled 
with the Sequencer to animate your images - only your 
imagination can hold you back. 


PROFESSIONAL SOFTWARE FOR THE ARCHIMEDES & A3000 


ln Se a A 


SOFTWARE 
69 SIDWELL STREET, EXETER EX4 6PH. TEL:(0392) 437756 FAX: (0392) 424762 


Understanding the Sound System 


David Spencer offers the technical low-down on the Arc's sound system. 


PF... issues of Risc User (Volume 3 
Issues 1 and 3) have included basic 
information on using the Archimedes’ 
sound system. In this article we will take a 
more detailed look at the subject and explain 
exactly how the sound system works. 


THE HARDWARE LEVEL 


Many computers use dedicated sound 
generator devices which consist of complex 
arrays of oscillators, filters, envelope 
shapers and the like. Unfortunately, all 
these suffer from the fundamental 
problem that the range of sounds that can 
be produced is limited by the hardware. 


Figure 1. A relatively simple waveform 


The Archimedes on the other hand 
adopts an entirely different approach. The 
key to the method used is that any 
waveform, however complex (such as that 
in figure 1) can be reproduced by knowing 
the value of the signal at only a few points 
on the waveform. To be precise, you need at 
least two samples per cycle of the 
waveform, which corresponds to sampling 
the signal at twice the maximum frequency 
that is required to be reproduced. Note the 
use of the word maximum. You might 
expect that two samples between points a 
and 6 in figure 1 would do the job, but in 
fact, the waveform depicted is that of a sine 
wave plus lower level sine waves at three 
times and five times the frequency of the 
base wave (so-called harmonics). Therefore, 
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to reproduce the waveform faithfully you 
would need at least ten samples between 
the two points, as the maximum frequency 
is five times the fundamental one which 
determines the wave length. 


Having got the samples, they need to be 
converted to digital values for storage. In 
the Archimedes eight bits are used per 
sample, one to show whether the signal is 
positive or negative, and the other seven 
for the absolute value. Rather than store 
the samples as linear values, the logarithm 
of the actual signal level is saved, to match 
the logarithmic response of the human ear. 


Within the Archimedes, the memory 
controller, MEMC, maintains an area of 
RAM as a sound buffer for the samples, 
and reads these out at a fixed rate. (There 
are in fact two buffers so that one can be 
refilled while the other is being used.) 
This data is taken by the video controller, 
ViDC, and converted to a signal using a 
digital to analogue (D to A) converter. The 
signal is then filtered and amplified before 
being passed to the internal speaker and 
headphone socket. Multiple channels are 
catered for by interleaving their samples 
in the buffer, and increasing the rate at 
which the data is output accordingly. For 
example, with two channels, the buffer 
data consists of a sample for channel one, 
followed by one for channel two, and then 
another for channel one and so on, and the 
transfer rate is double the value it would 
be for a single channel. The filtering on 
the output acts as a flywheel to turn the 
discrete samples into a continuous signal. 
Stereo is handled by steering the analogue 
signal to either a left or right output 
depending on the channel that the sample 
belongs to, and the programmed stereo 
position for that channel. 


It is worth pointing out at this stage 


that although we refer to ‘samples’, these 
are not necessarily sampled with a sound 
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sampler. We shall look shortly at algorithms 
that can generate the necessary sample data. 


THE SOUND SOFTWARE 

There is clearly a large gap between 
the D to A converter of the ARM hardware 
and the high-level sound commands 
offered by RISC OS. This gap is bridged 
by a number of modules that form part of 
the operating system. 


These sound modules are structured 
into a number of layers as shown in figure 
2, The lowest level is termed level 0 and 
consists of the module SoundDMA, The 
main function of this level is to control the 
allocation of the sound buffers needed by 
MEMC/VIDC and to handle the interrupts 
generated when the buffers need refilling. 
However, such refill requests are not 
handled by level 0 directly, but are instead 
passed up to level 1 as we shall see 
shortly. The level 0 software is also 
responsible for dealing with the 
operations that require direct hardware 
access such as changing the stereo 
position or turning sound on and off. 


Level 2 
(sound scheduler) 


> Level 1 
«| (sound channels) 
Level 0 — sound 
(sound DMA) — hardware 


Figure 2. The levelled structure of the sound software 


The level 1 software, implemented in 
the SoundChannels module is really the 
heart of the sound system. The main 
function of this level is to tie particular 
voices to the individual sound channels, 


and deal with commands to generate a 


note on any of these channels. As we have 
already said, the level 0 software informs 
level 1 when a buffer refill is needed. In 
this event, it is the level 1 software's 
responsibility to ensure that the buffer is 
filled correctly with the data for each 


channel interleaved in the correct way. 
Finally, level 1 provides a number of data 
tables that are needed by individual voices 
as described shortly. 


Level 2 is the section that deals with 
synchronising sounds, as covered in Into 
the Arc in the previous RISC User, This 
level is implemented by the 
SoundScheduler module and is largely 
independent of the other two levels. Notes 
can be queued with the level 2 software, 
typically using the five-parameter version 
of the SOUND statement. Level 2 
maintains a beat counter, and whenever a 
note is due to be generated it is removed 
from the queue and passed to level 1 as a 
normal sound command. 


FILLING THE BUFFER 

So far we have looked at a lot of 
‘management’ software, but nothing to 
actually generate the data needed to make 
a sound. This task falls to the individual 
voice generators. There is a separate 
generator for each voice (or class of voices) 
and these must fill the sound buffer with 
the correct data when called 
upon by the level 1 software. 


The method by which 
the data for the sound 
buffer is generated depends 
on the nature of the sound. 
In the case of a sampled 
sound such as human 
speech, the only solution is 
to store each sample in 
memory, or on disc, and 
simply transfer it to the 
sound buffer as needed. On the other 
hand, the data for some sounds can. be 
calculated as needed. For example, white 
noise can be created using a pseudo- 
random bit sequence generator which can 
be coded very efficiently in ARM code. 


However, the most common form of 
voice generator is based around a 
wavetable. Such a table is a list of values 
for one cycle of the desired waveform 
taken at equally spaced points. The 
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number of such samples is usually a 
power of two, such as 256 or 512. For 
example, a wavetable of the waveform in 
figure 1 could be made by storing the level 
of the signal at 256 equally-spaced points 
between a and b. The values stored are 
usually related to the logarithm of the 
actual level, in order to correspond to the 
response of the D to A converter in VIDC. 
The values are scaled such that the 
highest level is represented by the 
maximum value that can be stored in one 
entry of the table (usually a single byte), 
as this gives the best performance in 
terms of noise reduction in the final 
signal. The standard 'WaveSynth-Beep' 
voice is of the wavetable type. 


phase accumulator 
frequency increment 


channel 
volume 


Figure 3. Schematic of wavetable type synthesis 


Although the wavetable holds all the 
necessary data to generate the samples for 
the sound buffer, it cannot be used directly 
as it needs to be adjusted for the desired 
pitch and amplitude. Taking the pitch 
first, this can be done using a technique 
known as a phase accumulator. The idea 
is that when filling a buffer you keep a 
value which represents the phase of the 
waveform at that point (i.e. the position 
within a single cycle). The upper bits of 
this phase value can be used as an index 
into the wavetable to get the actual signal 
level at that phase. To generate each 
successive sample for the sound buffer a 
constant representing the frequency is 
added to the phase value at each stage, 
hence the term phase accumulator. The 
frequency of the resulting waveform is 
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determined by the value added to the 
phase, and effects such as frequency 
modulation or vibrato can be achieved by 
altering this value between samples. 


Having read a sample from the 
wavetable, the value needs to be scaled by 
both the overall amplitude as set by 
*VOLUME etc., and the particular 
amplitude specified in the SOUND 
command. Furthermore, effects such as 
amplitude modulation may be required. To 
achieve this, the level 1 software 
maintains a table of logarithmic scale 
factors for different amplitudes. Whenever 
the overall volume is changed this table is 
adjusted to take account of the change. As 
both the amplitude table 
and wavetable contents 
are in logarithmic form, all 
that is needed to scale one 
by the other is to add their 
values (remember that two 
numbers can be multiplied 
by adding their logs). 
Therefore, having read a 
value from the wavetable, 
the voice generator must 
get the appropriate 
amplitude table entry for 
the note's volume and add 
this to the wavetable value 
to give a final number 
which can be stored in the sound buffer. 
All of this is shown graphically in figure 3. 


FINDING OUT MORE 

If you want to make full use of all the 
sound system commands and SWI calls, or 
want to write your own voice generator, 
you will need to resort to the RISC OS 
Programmer's Reference Manuals. Part IV 
of this contains an extensive section on 
the sound system. This not only includes 
details of all the star commands and 
SWIs, but also describes the software 
interface between the various levels of the 
sound software. Furthermore, it has 
details on implementing voice generators, 
including examples of how to code them to 
run at the maximum possible speed - a 
critical criterion for sound code. RU 
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ARE YOU GOOD ENOUGH? 


As the leaders in software for the Archimedes range of computers, CLARES 
MICRO SUPPLIES are looking to extend our range even further. We are 
looking for people who are as excited by the Archimedes as we:are, 


If you have written any programs, completed or not, then we would like 
to hear from you. 


If you have any ideas for programs and have the ability to execute the 
ideas then we want to hear from you. 


If you have the ability to program the Archimedes but not the ideas to 
program then we want to hear from you. 


Programs can be written in any language as long as they perform their 
stated task. Many of our programs contain large chunks of BASIC with 
ARM code in the areas that it is needed. BASIC on the Archimedes is a 
very powerful language and we do not attach any snob value to its use. If 
your program does what is meant to do then thats all we are interested in. 
Why not join the top team on the Archimedes. You get the support of our 
in-house team, privileged access through us to Acorn and invitations to 
our informal programmers seminars, 


The most important point is that you will be earning top royalty rates of if 
you prefer we will purchase your program outright. 


Please write, in confidence, to Mr. D. Clare at: 


Clares Micro Supplies, 
98 Middlewich Road, 
Northwich, 
CHESHIRE CW9 7DA 


If you have a program either complete or in development then please 
enclose a copy for our evaluation. 


To protect yourself we advise that you lodge a copy of the program with 
your bank or solicitor BEFORE you send us a copy. You can then prove 
that your program pre-dates anything that we have. 


Act today and become part of the leading software team producing 
software for the worlds fastest micro. 


Gravity on the Archimedes 


Explore the effects of gravity on heavenly bodies in two dimensions 
with this program from Matthew Segall. 


lIthough the following article is quite 
technical in its content, the program 
listing is short and produces some 
fascinating results on the screen, so even 
if the mathematics do not interest you it is 
well worth trying the program. 


One thing that is not made clear about 
mathematics is that not all problems can 
be solved simply by finding solutions to 
the equations describing the problem. One 
of those which cannot is known as the N- 
body problem. This describes the motion 
of more than two massive objects under 
the action of gravity, an example being the 
motion of the planets in the solar system. 
For only two bodies a simple equation can 
be formulated to give the paths of the 
objects, but for three or more objects the 
interactions between them are just too 
complex for a simple solution to be 
obtained intrinsically, The solution can 
in fact only be found by repeatedly 
calculating the effect of all the objects 
on each of the others in turn. This task 
is very tedious to do manually and 
therefore a computer is ideal; 
specifically a powerful computer which 
can do the necessary calculations 
quickly. Even with the power of 
Archimedes Basic, once you have more 
than about five objects on the screen 
the calculations take so long that the 
display is very sluggish. 


When you run the program, you 
are asked to input the masses, 
positions and velocities of each body to 
be plotted. The positions should be 
given as screen co-ordinates, and the 
velocities in the form x-velocity, y-velocity. 
You will need to experiment to find 
sensible values, but a good starting point 
for mass is 1000 units for a sun and 
between 0.1 and 10 for a planet. Velocities 
might perhaps range between 10 and -10 
in either direction. Some example sets of 
figures are set up in DATA statements at 
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the end of the program, and read into 
function keys F1-F3 in lines 100-140. 
Pressing one of these keys when prompted 
for the number of bodies will enter all the 
figures for that particular simulation and 
start the display. 


The first example is what amounts to a 
simple binary star system, the second is a 
single planet orbiting a sun, and the third 
is a complete solar system with three 
small planets and one large one orbiting a 
much more massive sun. The last of these 
is probably the most interesting as it 
shows how a number of planets orbiting a 
single star affect each other’s orbit quite 
dramatically, In fact, if you let this run for 
a few minutes the orbit of one planet will 
be so drastically affected that it will fall 
into the sun. 


A fascinating display of planetary motions 
using one of the examples provided In the 
program. 

This brings us to the question of 
collisions between bodies. The program 
handles these by assuming that any two 
bodies which collide will ‘stick’ together to 
form one body; this is known as an 
inelastic collision. This is not an 
unreasonable assumption, as by and large 
this is what happens in nature although 
there is usually some small loss of both 
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energy and mass. For our purposes, 
however, this can be taken as negligible. 


PROGRAM DESCRIPTION 


The program consists of three loops. 
The outer one simply keeps the program 
running indefinitely. The second cycles 
through all the bodies in order, passing 
each item in turn to the third loop which 
then calculates the gravitational effect of 
each of the remaining bodies upon it. 
Collisions are dealt with by a simple 
procedure which calculates the new mass, 
velocity and size of the body formed by 
combining the previous two bodies. This 
information is put in the place of one of 
the colliding bodies and the other is 


removed from the list of active bodies. 


Each body is plotted on the screen as a 
red circle, its size being proportional to the 
cube root of its mass as is the case in 
nature. The previous position of each body 
is plotted in a different colour so that a - 
trace can be seen of the path of each. Line 
150 sets up a simple palette in the blue- 
green spectrum which is suitable for seven 
bodies, but you may wish to experiment 
with your own colours, or simply omit this 
line and use the default colours. Alternatively 
you can use mode 15 by altering line 150, 


Those of you familiar with this area of 
physics will note that the displays given 
by the program demonstrate Kepler’s first 
two laws quite well. These state that the 
orbit of a planet is always an ellipse with 
the sun at one focus, and that the area 
swept out by the line from the planet to 
the sun in a given time is constant; this 
can be seen because a planet will always 
move more slowly when it is far away 


from the sun than when it is close. 


The main limitation with this program 
is that the position and velocity of each « 
body can be held in the computer’s 
memory to only (!) ten decimal places, 
which results in rounding errors. These 
are most often seen as what is termed 
“precession of perihelion”, or in other 
words a slight change in the orientation of 
a planet’s orbit which is not caused by the 
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action of another body. The effect of this is 
insignificant if you are simply trying out 
different starting configurations, but 
decreasing the time step t in line 160 will 
give a more precise display if required. 
Increasing it, on the other hand, will 
speed up the display, at the expense of 
accuracy, if you are impatient and do not 
have the ARM processor! 


This program provides an example of 
the way in which computers can make a 
major contribution in many areas of 
science, and also of how well the 
Archimedes fulfils this role. It would also 
be an ideal program to demonstrate the 
speed increase which is possible by using 
the ARM3, consisting as it does of small 
loops containing mainly mathematical 
calculations and graphics. 


10 REM >Nbodies 
20 REM Program N-Body Problem 
30 REM Version Al.0 
40 REM Author Matthew Segall 
50 REM RISC User April 1990 
60 REM Program subject to copyright 
10: 
100 FOR I=1 TO 3:READ A 
110 K$="KEY"+STRSI+" "+STRSA+"|M" 
120 FOR J=1 TO A*5:READ B 
130 K$+=STRS$B+"|M" 
140 NEXT: OSCLIK$ : NEXT 
150 MODE12 
160 G=100:t=0.1:INPUT"No. of Bodies";N 
170 FOR I%=2 TO N+1:COLOUR I%,0, (I%-1) 
*36,252-SQR(I%-1) *36:NEXT 
180 DIM X(N) ,¥(N),Vx(N),Vy (N) ,M(N),r(N 
), TX(N) , TY (N) 
190 FOR K=1 TO N 
200 PRINT"Mass of sun ";K;: INPUT M(K) 
210 PRINT"X,Y position of body ";K; 
220 INPUT X(K),Y(K) 
230 PRINT"X,Y velocities of body ";K; 
240 INPUT Vx (K), Vy (K) 
250 r(K)=M(K) * (1/3) 
260 NEXTK 
270 TX()=X() :TY()=¥() 
280 CLS:0FF:REPEAT 
290 FOR K=1 TO N:IF M(K)<>0 THEN 
300 FOR L=1 TO N:IF L<>K AND M(L)<>0 T 
HEN 
310 R=FNdistance (X(K) ,Y(K) ,X(L),¥(L)) 
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Command Line History Buffer 


Repeat or edit previously typed commands with this utility from Mark Lock, 


The program is supplied on this month’s 
magazine disc only. 


When you are typing commands at the 
command line, whether it is the operating 
system star prompt, or within the Basic 
environment, it is often useful to be able to 
recall previously typed commands, repeat 
them, and sometimes edit them as well, for 
example if you wish to try something out 
with a set of varying values. The utility 
presented here will do this for you. It 
consists of a relocatable module which, 
when installed, can be activated by the 
command *HistoryOn, and de-activated by 
*HistoryOff. When turned on, a buffer 
stores all text entered at the command line. 
It is then possible to recall and edit any of 
the commands by using the following keys: 


The up and down cursor keys will cycle 
through the commands in the buffer. 


The left and right cursor keys move 
along the line being edited. 


The Home key moves the cursor between 
the start and end of the line. 


Characters may be entered in either 
insert or overtype mode: toggling 
between the two is done with the Insert 


Gravity on the Archimedes 


320 IF R<(x(K)+r(L)) THEN 

330 PROCcollision 

340 ELSE 

350 Vx (K)=Vx (K) +t*FNgravity (G,M(L) ,X (K 
),X(L),R) 

360 Vy (K)=Vy (K) +t*FNgravity (G,M(L) ,¥(K 
),¥(L),R) 

370 ENDIF 

380 ENDIF 

390 NEXT L 

400 TX (K) =TX (K) +t *Vx (K) 

410 TY (K)=TY (K) +t *Vy (K) 

420 GCOLO, K+1 

430 CIRCLEFILL X(K) ,¥(K),x(K) 

440 GCOLO,1 

450 CIRCLEFILL TX (K) , TY (K) ,r(K) 

460 ENDIF 

470 NEXT K 

480 X()=TX() :¥()=TY() 

490 UNTIL FALSE 

500 : 
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key. In insert mode a block cursor is 
used, and in overtype, an under score 
cursor. 


The Delete key deletes the character to 
the left of the cursor, while Shift-Delete 
deletes the character under the cursor. 
Ctrl-U deletes the entire line. 


The Copy key activates cursor editing, 
which is then used in the normal way. 
To de-activate it, use Ctrl-C. 


You can also display the contents of the 
buffer with *HList, and the amount of free 
space in the buffer with *HStatus. 


The program on the magazine disc is a 
Basic program which, when run, assembles 
the module code. You will then be prompted 
to enter the filename, and the module will 
be automatically saved with that name. 
Once saved, the module may be installed by 
typing *RMLoad <filename> from the 
command line or by double-clicking on its 
icon in the directory viewer. 


The program as published allows 4K of 
buffer space. This can be increased if 
required by amending line 110 in the source 
program. RW 


1000 DEF FNgravity (a,b,c,d,e) 

1010 =a*b* (d-c) / (e*3) 

1020: 

1030 DEF FNdistance(a,b,c,d) 

1040 =SQR ((a-c) *2+ (b-d) *2) 

1050 : 

1060 DEF PROCcollision 

1070 Mass=M(K) +M(L) 

1080 VelX= (Vx (K) *M(K) +Vx (L) *M(L)) /Mass 
1090 VelY=(Vy (K) *M(K) +Vy (L) *M(L)) /Mass 
1100 M(K) =Mass: Vx (K) =VelX: Vy (K) =VelY 
1110 r(K)=Mass* (1/3) :M(L)=0 

1120 GCOLO,0:CIRCLEFILL X(L) ,¥(L) ,r(L) 
1130 ENDPROC 

1140 DATA2, 1000, 230,512,0,3,1000,870,51 
2,0,-3 

1150 DATA2,1000,640,512,0,0,0.1,840,512 
1 0,22.360679 

1160 DATAS, 1000, 640,512,0,0,0.1,840,512 
,0,10,0.1,240,512,0,-5,10, 640,1000,-5,0, 
0.01, 940,512, 0,18.25741858 AW 
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Premier 3/ The Archimedes 
Text Processor 


Full word processing of - 


* Invoices 

* Reports 

* Letters 

“* Statements 
* Circulars 
* Etc. 


Tax Points 21st Ju 


Che 


tirte 


Acme Trading Co, Ltd; 


Premier’s unique Dynamic 
Text feature is a simple yet 
powerful concept which puts 
you the user in complete 
control for the first time. It 
provides - 


Acme Trading Co. Ltd. 
suring Gardens Est 


* Automatic data linkage 
between documents. 


Hilda as 


ngfelt wants 


* Flexible control over 
document formatting. 


*k The simplest printer 
control yet devised. 


A New Type of Program 
Premier's Dynamic Text ere power command language combine to provide the best solution to text processing 
problems at home or in the office. It puts the user in greater control than ever before, by offering greater freedom 
and flexibility. All program functions may be modified by the user, while command macros may be written to meet 
any specific user requirement, 


All this is available from just one program, which is fully multi-tasking under RISC-OS, and comes complete with 
220 page user guide, separate word-processor manual, key strips, and new 10,000 word thesaurus, for just £120 


plus VAT. 
Circle Software 


ili 
independent control of screen and printer output. Older version discs may be 
upgraded free of charge (including full notes on disc), or complete with the new 


word processor manual and thesaurus, for £17.35 + VAT. 33, Restrop View, 
Purton, Swindon, 

Premier 3 may be purchased directly by phone, quoting your MasterCard Wilts. SN5 9DG 

(Access) or Visa card number, or from your nearest Acorn dealer. Educational Tel: 0793 770021 


discounts and multi-machine licences are available. 


Reviewed by Lee Calcraft 


SEs Hewlett-Packard DeskJet Plus 
printer uses ink jet technology to obtain 
an output quality approaching that of the 
laser printer. Yet it costs only a fraction of 
the price, weighs a mere 14 lb (the 
Panasonic KX-P4450 laser printer weighs 
56 lb), and requires a minimum of 
maintenance, 


The design of the DeskJet Plus reflects 
its hybrid nature. It uses a stack of ready- 
cut sheets like a laser printer, and handles 
them in a similar way, but the printing 
mechanism is more like that of a dot 
matrix printer in that the paper is printed 
a line at a time by a moving horizontal 
head - though in this case, the head 
contains an ink cartridge, rather than a 
bunch of pins which impress on an inked 
ribbon. 


The paper bin takes around 100 
sheets, and is easily accessed at the front 
of the printer. What I particularly like 
about the arrangement is that you can 
add paper to the bin without disturbing 
the printer in any way - the paper just 
slides in without the necessity of removing 
the bin itself. And even better, there is an 
envelope feed mechanism built in. 


The Hewlett Packard DeskJet Plus Printer 


Immediately on top of the paper bin is 
the collecting tray for printed sheets. 
This latter uses a mechanism to hold 
each emerging sheet until it is completed, 
and then drops it onto the output pile 
(face up in reverse order unfortunately). 
The reason for the contrivance is 
presumably to prevent ink on one sheet 
being smudged by the 
arrival of the next. And I 
have to say that I 
experienced no smudging, 
during tests, though dense 
graphics dumps were 
noticeably damp, and showed 
some signs of temporary 
wrinkling of the paper. 


The DeskJet comes with 
both serial and parallel 
interfaces, and links to the 
Archimedes via _ either, 
though the parallel 
(Centronics) option is the 
favourite, because it does 
not require comms protocols to be set up, 
and provides a faster data transfer. 


Underneath the printer at the front 
are 16 DIL switches, These must be set up 
correctly before using the printer. They 
control such things as which of the 10 
resident fonts is in use, whether line feeds 
accompany carriage returns, what paper 
size is in use, and whether there is 
automatic perforation skip. The manual 
makes everything clear, though it seems 
primarily aimed at IBM PC and Apple 
Mac users. For other computer users, the 
best bet is to use the general switch 
setting diagram in the appendix. 


Once you have set the switches, and 
connected the serial or parallel link, the 
printer is ready for use. To list a program, 
just use Ctrl-B (or VDU 2), and then type 
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The Hewlett Packard DeskJet Plus Printer 


LIST, as normal. If you are using a 
package such as Edit or Acorn DTP, which 
make use of the printer drivers, then this 
is also very easy. Just install the LaserJet 
printer driver by double-clicking on its 
icon, select a suitable resolution (150 dpi 
for draft or 300 dpi for high quality 
output), and either drag the file you want 
to print to the 
printer driver, or 
select the Print 


Sample 
option from with- 


from Twin; on graphics dumped using 
Paint; and on DTP files containing text, 
graphics and Draw files using Impression. 
In all cases the quality was excellent, and 
even on close examination it was difficult 
tell whether the printout had been 
produced on the DeskJet or on a 300 dpi 
laser printer. 


text in DRAFT mode 
? 


in th ; 
sieidaiinieds Sample text 


in LETTER QUALITY mode 


Note that for 
graphics output 
in particular it is 
essential to set 


* 
DeskJet GRAPHICS mode output at 300 dpi 
using the Archimedes printer driver 


the Paper size 
and Skip over 
perforations 
options correctly, 
or you will lose 
text at the 
bottom of each 
page. Assuming 
that you are 
using standard photocopier paper, set the 
size to A4, and set Skip over perforations 


to Off. 


If you are using the printer with a 
package which does not make use of the 
standard printer drivers, you will need to 
be aware that the control codes used by 
the DeskJet are not Epson compatible. In 
fact they form an almost complete subset 
of the LaserJet codes. It will usually be 
quite straightforward to alter the codes 
used by a particular package to take 
account of this - if they are not already 
provided by the software itself. 
Alternatively, you can purchase an Epson 


emulation cartridge for the DeskJet (atu 


around £70 inc. VAT). 


OUTPUT QUALITY 

I tested this printer on plain text 
output, both in the form of program 
listings and ASCII text files printed out 


* 
300 dpi ouptut from the Panasonic 
KX-P4450 laser printer for comparison 


DeskJet Plus sample text output in both text and graphics modes. 
in graphics mode the quality compares favourably with 
300 dpi laser printer output. 


As for the printing of plain text using 
the printer’s internal fonts, this too was 
excellent, with the draft mode selectable 
from the front panel producing less dense, 
but quite acceptable copy. Draft mode 
selection did not affect the quality of 
graphics output: here draft modes could be 
selected by using the Archimedes’ printer 
driver options to set 150 rather than 300 
dpi. 


TIMINGS 

Table 1 gives the timings for a variety 
of tests. The first two give the average 
times for an A4 page in text mode. The 
first is for a program listing, and the 
second, a dense piece of text. If the 
program had shorter lines, or the text 
more paragraphs, shorter timings would 
have resulted. The official output speed 
of the printer under these conditions is 
120 cps in letter quality mode, and 240 
eps in draft mode. My figures work out 
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somewhat worse than this, but 
manufacturers’ official times do not 
usually take line feeds or page feeds into 
account. In laser printer terminology the 
timings yield around one page per 
minute in letter quality mode for a 
densely covered page. This is a good deal 
slower than a laser printer, though it 
speeds up as the quantity of text per 
page decreases, reaching a maximum of 
around 7 pages per minute for completely 
blank pages. 


Test 
Program list 
ASCII text 


Draft 
27s 
36s 
39s 
55s 

1m 26s 


High res 
36s 
56s 

3m 20s 
2m 27s 
5m 35s 


Draw file 
Mode 12 screen 
Impression page 


Table 1. DeskJet output timings. 


The final 3 timings are for graphics 
mode output. In each case the Archimedes’ 
printer driver sends a 
bit image to the 
printer line by line 
until output is 
complete. Here the 
timings are almost 
exactly the same as for 
the Panasonic KX- 
P4450 laser printer, 
which uses HP 
LaserJet emulation. 
Moreover, as I said 
earlier, the quality is 
indistinguishable 
from laser printer 
output. than its successor. 


CONSUMABLES 


The only item needing periodic 


replacement in the DeskJet is the ink» 


cartridge. This is easily accomplished, and 
at £17 inc. VAT lasts for 1,000,000 
characters in draft mode, or 500,000 in 
letter quality mode. Assuming that on 
average each page will be only half filled 
(because of spaces between words, and 
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The DeskJet 


If you are considering the purchase 
of a DeskJet Plus, you may also be 
interested in its predecessor, the 
DeskJet. This printer uses a different 
processor (a Z80 instead of the Z180 
used in the Plus), and is considerably 
slower in both text and graphics modes 
(up to twice as slow in text modes, and 
up to 5 times slower in graphics modes). 
It has only 4 internal fonts (where the 
Plus has 10), and does not support 
landscape graphics mode (i.e. sideways 
pages), but it retails at around £100 less 


The Hewlett Packard DeskJet Plus Printer 


blank lines), this works out to around 4p 
per page in draft mode and 8p per page in 
letter quality mode. The foregoing relates 
to text mode printing only. The cost of 
printing each page of graphics will depend 
on the density of the image. 


CONCLUSION 

The DeskJet Plus is without doubt an 
excellent printer for its price. Its output 
quality in all modes of operation is 
comparable to that of a 300 dpi laser 
printer, and in graphics modes its speed 
of response matches that of other 
LaserJet compatible laser printers. In 
text mode, its output quality is excellent, 
and is comparable in speed to a 
reasonably fast dot matrix printer, 
though is considerably slower than a 
laser printer. 


It is extremely light in weight, 
completely silent in standby mode (unlike 
a laser printer which 
needs a fan running 
all the time), and very 
quiet during printing. 
Its only drawback 
seems to be the price 
per page of con- 
sumables, and its 
(relatively) slow 
speed in text mode. 
But it is only slow 
compared to laser 
printers; compared to 
dot matrix units it 
has a good through- 
put, and its draft 
quality is better than 
most. This printer 
thoroughly deserves its already excellent 
reputation. 


The HP DeskJet Plus at £669.95 inc. VAT and the 
HP DeskJet at £569.95 inc. VAT are both available 
from BEEBUG - tel. (0727) 40303. 
The Hewlett Packard Customer help-line is on 
(0344) 369 369. 

AW 
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PIPEDREAM 3 


ie PipeDrean: adfs::a44@uini.$.pd.ExanplesPD.AdSS Th 
| RissreereevegerreeBrrvenelerronscDrrsreeEoaeveeks AE | 
| Car Lovers Annuai Report on Company Fieet 
| Value Value % 
year ago row ome Chey Cols Reg 

| Porsche CarreraRSL £50,000 £150,000 300.0% 0 & RS 27 

AC Cobra 289 MkIT $40.00 £150,000 166.7% 4.700 R289. COB 

JaguarD type £375,000 £98000 253.3% 3800-6 DI 

Ferrari 250 SWB £300.00 £1,100,0C0 220.0% 3300 12 SWB 250 

Feiratt 408 GTB £350c0 “£60,000 171.4% 3000 & GTB 308 


Comment Fleet values 


1 

2 

3 

4 

5 

6 

? 

8 

9 

8 

1 

DAs you can see from 
3 the graph on the tight 
4 hard side, the Car 
Lovers investment in 
(6 superb classic cars has 
2 performed outstand- 
3 ingly. outstripping 
9 most’ ccaventional 
8 forms of investment. 
i 
2 
3 
4 
5 
6 


‘The outlook remains 
sy, wth more 


invesiment funds. ao 
hocnig solo Ane Presche RS AC Cobra laguar Fenn SWE bernaty M8 


market. 


PipeDream 3 breaks down the barriers between word processor, spreadsheet and database. You can 
include numerical tables in your letters and reports, add paragraphs to your spreadsheets, and perform 
calculations within your databases. 


Based on PipeDream 2, the best-selling integrated package for the Archimedes, PipeDream 3 has been 
completely re-written to take full advantage of RISC OS - if you can use RISC OS, you can use PipeDream 
3. Itis fully multi-tasking and multi-windowing, so you can workon many documentsat onceand instantly 
move information between them. And since PipeDream 3 can automatically load and save most popular 
file formats, including VIEW and First Word Plus, switching to it from other programs has never been 
easier. 
Power, flexibility, speed, ease of use. PipeDream 3. Breaking down the barriers, 
Fora free brochure, see your Archimedes dealer, or phone us on 0954 211472 or return the coupon. 
PipeDream 3 is for all Archimedes computers with RISC OS and 1Mbyte of RAM. 
PipeDream 3 costs £147.00 +VAT. 


Major features include: 


+ many documents loaded at once «automatic loading of VIEW. —_[ 4 — 
* intuitive RISC OS user interface ViewSheet, Lotus, First Word For a free brochure, complete and retum this coupon 
* displaying and printing Plus, Tab and CSV files IPipeDream 3.01 View Professional 
of pictures within text * automatic saving of VIEW, [Name 
+ built-in 93,003 word Lotus, Acorn DTP format, Tab | Address 
spelling checker and CSV files | 
* file compatibility with * multi-field sorting | 
PC & 288 PipeDream and * use of all available fonts | Post code 
BBC View Professional * 62 spreadsheet functions 
* background recalculation «external references for 3-D [Cotton Software, Broadway House,149-151 St. Neots 
+ keystroke compatibility modelling |Road, Hardwick, Cambridge CB3 7QJ, England. 
with 288 & PC PipeDream * macro file recorder Fax: 0954 211607 Tel: 0954 211472 
+ 288 filing system * slot protection = ae 


‘Alt trademarks clrowled ged. The chart im the screen shown above was produced by sending numbers from PipeDream 3 ta Lingenuity’s Presenter 2.and then loading the resulting graph 
‘back nto PipeDrezm 3. 


Colton Software, Broadway House, 149-151 St. Neots Road, Hardwick, Cambridge, CB3 7QJ, England. 
Fax, 0954 211607 Tel. 0954 211472 
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David Spencer and Stephen Streater explain why the ARM processor 
offers such high performance, and how to make full use of this. 


n this article we will take a look at 
what gives the ARM processor its 
incredible performance, and offer a few 
hints to ensure that ARM programs 
execute as fast as is possible. 


DOWN THE PIPELINE 
One of the key concepts that gives the 
ARM its speed is known as pipelining. To 
understand what this is and how it 
works we need to look at how a typical 
processor goes about its duties. 


In general, each and every 
instruction goes through three distinct 
phases. Firstly, the instruction opcode 
is fetched from memory. Secondly, it is 
decoded to decide which actions must 
be performed, and the third step is to 
actually perform them. Each stage 
involves a different section of the 
processor's circuitry. It is obvious that 
if instructions are processed strictly 
one after the other, only a third of the 
processor will be in use at any one 
time. For example, while the 
instruction is being decoded, the 
execution and fetch sections are idle. 


With pipelining, this waste is 
avoided by ensuring that all three 
sections are used at once. To achieve this, 
as soon as one instruction has passed from 
the fetch to the decode section, the now 
free fetch section is used to start work on 
the next instruction. Similarly, as soon as 
the execution section is free it starts work 
on the next instruction which will have 
been deceded by this time. 


INSTRUCTION TIMINGS 

With a pipelined processor such as the 
ARM, it is not possible to calculate the 
execution time of each individual 
instruction, as the execution is overlapped. 
A useful measure, however, is the time 
between the completion of one instruction 
and the next. By adding together the 
figures for every instruction in a routine 
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you can get a good measure of the time 
that the routine will take to execute. Table 
1 gives the timing figures for each 
instruction (excluding co-processor ones) in 
terms of numbers of J, S, and N cycles, the 
meaning of which will be described shortly. 
You will see that some instructions take a 
fixed time, while others depend on the 
exact nature of the operands. 


Instruction Timing 
1S 
18+1S 


Data processing 

Data processing with register 
shift 

Data processing with PC 
modified 


28 +1N 


Load 
Load PC 
Store 


18+1N+1I 

28 +2N+11 

2N 

nS+1N+1I 
(n+1)S+2N+11 
(n-1)S+2N 

28 +1N 

2S +1N 

18+mlI 


Load multiple 

Load multiple with PC 
Store multiple 
Branch/branch with link 
SWI 

Multiply/multiply & add 


n=No. of registers transferred 
m=Value between 1 and 16 depending on multiplier 


Table 1. Instruction timings 


The I, S and N in table 1 refer to the 
type of operation the processor is 
performing - internal, sequential and non- 
sequential respectively. An internal cycle 
is when noaccess to memory is needed, A 
sequential cycle involves a memory access 
to the address one greater than the last 
access (for example an access to address 
&9878 following an access to &9874). An 
N cycle on the other hand occurs when an 
access is not to an address one greater 
than the previous one. Both J and S 
operations take one cycle of the ARM's 
clock input, while an N operation takes 
two clock cycles. On the Archimedes, the 
clock frequency is 8MHz, giving a cycle 
time of 125nS. Hence, a branch takes 2S + 
1N = 2*125+250 = 500nS. 
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Unfortunately, the way the ARM's 
memory controller accesses RAM means 
that the location of the next instruction in 
memory affects the execution speed. The 
exact figures are very cumbersome to work 
out, but will always lead to a slower speed 
than would be expected from table 1. 


Considerable speed is also lost in high 
resolution screen modes, as the ARM is 
halted while the screen data is read. 
Similarly, interrupt handling slows down 
the effective speed of execution of a 
foreground program. 


SPEEDING UP YOUR PROGRAMS 


Having looked at how instruction 
timing is calculated, we can now consider 
how to optimise an ARM code program for 
maximum speed, The first consideration 
is: "Am I using the best possible 
algorithm?". However cleverly you code an 
algorithm, it will not make up for it being 
a slow algorithm in the first place. For 
example, a Fourier-type division routine 
(in which you subtract and rotate the 
dividend) will on average perform much 
better than a very simplistic routine using 
repeated subtraction. In many cases, the 
choice of algorithm will be obvious, but in 
more involved cases it is worth doing a bit 
of research to find the best method. 


Having chosen the correct algorithm, 
the next stage is to code it as efficiently as 
possible. There are a number of simple 
ground rules here: 


@ Use the lowest resolution screen mode 
possible (or more precisely the mode that 
takes the least memory). A change of 
mode can affect the performance by a 
factor of up to ten. 


@ Avoid branch instructions. As these 
change the flow of a program they force 
the pipeline to be cleared, as the 
instructions fetched and decoded will not 
now be executed. Instead, you should 
exploit the feature of the ARM which 
allows any instruction to be executed 
conditionally. For example, consider the 
problem of converting a character to upper 


case if it is a lower case letter. One way of 
doing this would be with the code: 

CMP RO, #ASC"a" 

BLO exit 

CMP RO, #ASC"z" 

BHI exit 

BIC RO,RO, #620 

exit & ae 

This takes 5 clock cycles if the character is 
a lower case letter, and either 5 or 7 
otherwise (depending on its ASCII code), 
A much better alternative is: 

CMP RO, #ASC"a" 

RSBHSS R1,RO0,#ASC"2" 

SUBHS RO,RO, #620 
This performs the same function, but takes 
just 3 clock cycles regardless of the 
character. This saving may not seem a lot, 
but imagine a case-insensitive string 
sorting program which may need to perform 
this operation many thousands of times. 


@ Keep as many working variables as 
possible in registers. Most data operations 
on registers take just one cycle, whereas the 
overhead for loading and saving the value to 
and from memory first is considerable. 


@ Take full advantage of the ARM's 

barrel shifter. Shift and rotate operations 

can usually be combined with data 

operations with very little overhead. For 

example, calculating RO=2R0+R1 can be 

done in one cycle using the instruction: 
ADD RO,R1,RO0,ASL #1 


Multiply instructions in which one 
operand is a constant can often be 
replaced with a MOV, ADD or SUB 
involving shifts. 


@ Count loops backwards using the 
SUBS instruction. This avoids a compare 
operation as you just count down until the 
counter hits zero. This might only save 


, one cycle per loop, but it soon adds up if 


the loop is executed many times. 


In short loops where the looping 
branch takes up a sizeable portion of the 
execution time, unroll the loop by 
repeating the loop's contents several times 
and reducing the loop count accordingly. 
(See the example later.) 
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@ Avoid using the floating point 
instructions at all costs. In almost all 
cases where fractional decimal number 
are needed, they can be worked to a fixed 
precision and scaled into integers. For 
example, if you only require precision up 
to 0.01, multiply all the numbers by 100 
and treat them as integers. 


@ In extreme cases disable interrupts. 
This can be done using either the SWI 
"OS_IntOn" and “OS_IntOff" calls, or by 
directly changing the flags (see the 
previous two Assembler Workshops). 
Remember, though, that this will halt 
background functions such as keyboard 
handling, and hence interrupts should 
only be turned off for a few milliseconds at 
a time. 


THE 80-20 RULE 

There is a rule of thumb in computing 
that can save a lot of time and effort 
when trying to improve the performance 
of a program. The rule, called the 80-20 
rule, states that 80% of the execution 
time is taken up by just 20% of the 
program. For example, consider a 
program that takes some input from the 
user, processes it in a loop which is 
executed many times, and then outputs 
the results. The loop may only make up a 
fraction of the code's length, but will 
probably take up the bulk of the 
execution time. Clearly, time spent 
improving the bit of code which takes up 
most time will be more profitably spent 
than trying to concentrate on all the code. 


AN EXAMPLE 

In order to illustrate the techniques 
outlined above, we will consider a simple 
routine to calculate the 22nd value in the 
Fibonacci series (a series in which each 


member is the sum of the previous two -' 


0, 1,1, 2, 3, 5, 8 etc.). A first attempt is: 
MOV RO, #0 

MOV R1,#1 

MOV R3,#0 

ADD R2,R0,R1 

MOV RO,R1 

MOV R1,R2 


. loop 
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ADD R3,R3, #1 

CMP R3,#20 

BNE loop 
Each pass through the loop takes 9 clock 
cycles (4 of them for the branch), and 
hence the entire routine takes 3+9*19+6 
= 180 cycles. This is made up of 3 cycles 
for the initial register setup, plus 19 
times round the loop, plus a final pass of 
the loop in which the branch is not 
taken. 


The first improvement is to reverse the 
loop, counting down from twenty, rather 
than up to it. This saves one compare from 
each iteration of the loop, and hence 
reduces the total number of cycles by 
twenty, bringing it down to 160. 


Next we can replace the two MOV 
instructions within the loop by an ADD, 
and calculate two terms per iteration. 
This gives: 

MOV RO, #0 

MOV R1,#1 

MOV R3,#10 
ADD RO,RO,R1 
ADD R1,R0,R1 
SUBS R3,R3,#1 
BNE loop 


. loop 


Note that we now only need ten iterations 
to get the desired result. The whole 
routine now takes just 3+7*9+4 = 70 
cycles, and also uses one less register. 


Finally, the BNE now takes 4/7th of 
the loop execution time. By duplicating 
the loop contents we end up with: 

MOV RO, #0 

MOV R1,#1 

MOV R3,#5 

ADD RO,RO,R1 

ADD R1,R0,R1 

ADD RO,RO,R1 

ADD R1,R0,R1 

SUBS R3,R3, #1 

BNE loop 

The execution time is now reduced to 
34+9*4+6 = 45 cycles. Hence, we have 
reduced the execution time to 25% of its 
original value with a bit of thought and a 
few tricks. Rw 
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by Mike Williams 


T his month I want to turn my attention 
to two of the items on Applications disc 2, 
supplied with your system. Both of these, 
in their different ways turn the 
Archimedes into something very close to a 
BBC micro. They are the two emulators 
65Host and 65Tube, the latter hidden in 
the Modules directory. By using these two 
emulators, a wide variety of software 
designed for the earlier machines can be 
run successfully on an Archimedes, 
including commercial software as well as 
to your own programs. And even if you 
never previously used a BBC micro, you 
may wish to experiment with these 
emulators, and perhaps try out some of 
the huge variety of BBC programs around. 


You will, of course, have to find some 
way of reading your BBC micro dises, or 
transferring their contents to your 
Archimedes. The serial link kit (available 
from BEEBUG) allows a BBC micro and 
an Archimedes (including an A3000 if the 
relevant chips are fitted) to be connected 
via their serial ports. Files of all kinds can 
be transferred and saved on new 3.5” 
discs. Alternatively, existing disc drives 
can be connected to an Archimedes as 
additional drives, using the BEEBUG disc 
buffer (not yet available for the A3000). 
BEEBUG’s DFS reader also allows the 
Arc to read DFS format discs, but unlike 
ArcDFS from Dabs Press (reviewed in this 
issue) does not provide a full DFS system. 
Owners of a Master Compact can use all 
their existing 3.5” ADFS discs directly on 
an Archimedes with no problems at all. 


With ROM based software, you will 
need to install a ROM podule in your 
Archimedes, or obtain a copy of the 
software as a ROM image on disc (more on 
this later). 


You should find that many BBC micro 
programs in Basic can be loaded and run 
on the Archimedes in native mode, that is 
without using any emulator at all. Basic V 
supplied with the Archimedes is an 
enhanced version of the BBC Basic used 
previously, so provided your programs are 
strictly within the Basic environment, all 


should be well. Many programs, 
particularly graphics animations, will run 
much faster, and such programs can often 
take on a new lease of life. The one feature 
that is different on the Archimedes is 
sound, and you may find any output of 
this kind distorted, unrecognisable, or just 
non-existent. 


Clearly, any 6502 assembler embedded 
in a Basic program will fail, because Basic 
V only assembles ARM assembler, to run 
on the ARM processor. That also applies to 
any assembled 6502 machine code, and 
that is why many Beeb games for example 
will fail. However, this problem can be 
overcome to a large extent by using one of 
the two 6502 emulators described here. 


Other reasons why old programs can 
fail on the Archimedes are the inclusion of 
any direct memory references including 
the saving and loading of screens (memory 
is organised differently on the 
Archimedes), page zero references, calling 
entry points in the Basic ROM (or 
similar), referencing the DFS specifically 
(the Arc uses only the ADFS), and any 
other form of reference or access which is 
not supported by RISC OS. The 65Host 
emulator in particular can overcome many 
such problems. 


Sometimes quite simple things can 
cause a problem. On the Archimedes, the 
concept of a current directory no longer 
exists - all file pathnames should be given 
explicitly and in full, viz: 

adfs: :<title>.$.<directory>.<filename> 
where <title> is the title of the disc, 
<directory> may be repeated depending on 
the level of nesting, and <filename> is the 
name of the file itself, e.g.: 

adfs: :MyDiscl.$.Programs .Utils. Loader 
This is usually an easy matter to change 


* once the problem has been recognised. It 


is always better to modify a program to 
run without an emulator if you can - it is 
likely to run faster, and it gives you the 
opportunity to modify or add to the 
program using the extended features of 
Basic V. However, this will not always 
work, and thus the need for an emulator. 
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An emulator is just a program which 
you run in your machine. Once installed it 
creates an environment as near as 
possible to that being emulated. However, 
the emulation can seldom be perfect, and 
sheer physical differences between the 
host machine and that being emulated can 
make it impossible. For example, there is 
no way to emulate colour graphics on a 
micro which does not support colour. 
Moreover, the extra work involved means 
that the emulated version will often be 
slower, though the intrinsic high speed of 
the Arc can compensate for this. 


In principle, an emulator can work in 
one of two ways. It can either perform the 
tasks required itself, or it can translate 
these into equivalent tasks to be performed 
by the host machine. Most emulators use a 
mixture of the two, as we shall see here. 
Broadly speaking, 65Tube emulates a 
6502 second processor, interpreting 6502 
machine code to RISC OS and supporting 
a 6502 based version of Basic (HiBasic). 
65Host on the other hand tries to provide 
much more of a complete system 
emulation, including Basic, operating 
system and hardware. However, it is not 
always possible to predict which emulator 
will give the best result, so if one doesn’t 
work, then try the other. 


This appears in the directory viewer 
for Applications disc 2, and can be 
installed by simply double clicking on its 
icon, After a pause, the screen will revert 
to a simple black-and-white display in 
mode 7, showing the legend (in three 
lines) of BBC Computer 32K, Acorn ARFS, 
and BASIC. You effectively have a BBC 
model B running OS version 1.2 and Basic 
II, and, of course, ADFS. As a result, you 
will find PAGE (the start address for Basic 
programs) set at &1B00 and HIMEM (the 
boundary between Basic’s area of memory 
and that used for the screen display) at a 
value depending on the mode selected. 
Any attempt to reduce PAGE below this 
value will hang the machine. Pressing 
Break (but not Escape) will perform the 
equivalent of Break on a BBC micro (i.e. it 
will reset the emulated BBC micro 
clearing the screen and re-displaying the 
start-up message). 


Because of the high value of PAGE you 
may find that programs which used to run 
on a BBC micro no longer do so because of 
insufficient memory. In such cases 
6502Tube may be a better bet. 65Host 
supports direct screen access, so you can 
*SAVE and *LOAD screens. It also 
supports sideways ROMS. If you type 
*ROMS you will see that Basic appears as 
ROM 12. This means, too, that if you fit a 
ROM podule to your Archimedes, you 
should still be able to access those ROMs 
as before. However, that does not 
necessarily guarantee that the ROM will 
still work correctly (we would be 
interested to hear from readers which 
BBC ROMs have been found to function 
on an Arc). 


In addition, for an upgrade charge, a 
number of the more popular ROMs have 
been released as ROM images on disc 
which can be loaded into emulated 
sideways RAM for easier access. This 
applies to View, Wordwise Plus, and 
Interword for example. Note, that in 
general, better results will be obtained by 
using ROMs or ROM images under 
65Tube, rather than 65Host. On the 
Master Compact, View was always 
supplied on 3.5” dise and this same 
version can be loaded and used on an 
Archimedes using 65Tube (see later). 


When you have finished using 65Host, 
typing *Quit will allow you to exit back to 
the Desktop (the emulator by its nature is 
not multi-tasking, so you can’t have a 
BBC micro in one window, and other 
activities in operation at the same time). 


Once you have installed 65Host, you 
don’t have to reload it from the 
applications disc if you want to use it a 
second time. Just enter *EmulateBBC 
from the command line prompt. However, 
if you enter the emulator this way, the 
*QUIT command returns you to the 


_ command line prompt, not to the Desktop. 


If you obtained the command line prompt 
by pressing F12, then on exit from the 
emulator, pressing Return will take you 
back to the Desktop. 


If you refer to the short chapter on 
65Host in the User Guide, you will see 
that it recognises a number of star 
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PRODUCT NEWS FOR 
/-A USERS! 


SCSI CARD AND DRIVE S 


Everything you need to upgrade your 
A3000 or Archimedes. ; 
Interface card £ QO+VAT = Hard Drive Kits £ 00+VAT 
ron 149 tert 375 


‘PRESENTER II PRESENTER STORY 


- A series based presentation software 

RISC OS based ; that allows you to make slides and 

graphics package (graphics, : o.h.p’s obsolete. £ gp+vat 
charts etc...) for education 199: 


and business. 
£39,95+VAT 


& / 
Coming SOOM 
COLOUR CONVERTER a 


Software and hardware card for capturing 
full colour images using the monochrome (60) H@)0) 5} DIGITISER 


Watford Digitiser and colour video equipment. 


Single card real-time full colour 


EN RD £16 Q.95°VAT digitiser for Archimedes 


(fim Education discounts and site licences for software are available 
—_— 


aa eae U1 1 [SALES HOTLINE 
: 098 685 477 


Please send me more information about: SCSI O Presenter 110 Colour Converter 0 


Wood Farm, Linstead Magna, Halesworth, Suffolk IP19 ODL 


Presenter Story O Colour Digitiser 0 


Name Address 


Tel No 


LINGENUITY, Wood Farm, Linstead Magna, Halesworth, Suffolk IP19 ODU A DIVISION OF 
LINDIS INTERNATIONAL 


Tel: 098 685 477 RU wo 
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commands. Apart from *Quit, all the other 
commands are only effective before 
entering the emulator (i.e. from the 
command line prompt again). Among 
other functions, these commands allow 
ROM images on disc to be loaded 
automatically when the emulator is called. 
*LinkROM is used to specify a ROM 
number and file name. The ROM image 
will then be loaded when the emulator is 
invoked, provided the relevant disc is in 
the drive at that time. 


There are some further star commands 
which can be used within the emulator. 
The only information on these is in the 
Readme file in the application directory 
for 65Host (double click on the 65Host 
icon while holding down Shift, and then 
load the Readme file into Edit). *Reset 
will reset the emulated machine, with 
*Reset 1 performing the equivalent of a 
power-on reset. *OS gives the “ prompt 
(in the emulation), while *GO (see later) 
will branch to a 6502 memory location. 


There are some limitations, of course, 
to what can be achieved with 65Host. It is 
slower than 65Tube because of all the 
extra work it has to do, and this can be 
quite noticeable - for example, when 
changing mode. It also requires 128K of 
memory to run. There are also a number 
of limitations with regard to hardware (1 
MHz bus, User port etc), These are 
documented in the User Guide. Although 
it is the more comprehensive of the two 
6502 emulators provided, you may be 
better off using 6502Tube for the better 
speed, if this emulation suffices. 


65TUBE 


The other 6502 emulator is in the 
modules directory on Applications disc 2. 
Double clicking on its icon will load the 
emulator and open a window on the 
screen showing that it has been installed. 
Checking will show that PAGE is now at 
&800, and that HIMEM is at &B800. This 
much larger memory area (44K) is 
available at all times regardless of mode 
because 65Tube passes all screen 
commands to RISC OS to carry out, rather 
than doing it itself. The initial display also 
shows that HiBasic has been loaded. 
HiBasic is the version of BBC Basic 
originally supplied with 6502 second 


RISC User April 1990 


processors (because of its different 
memory address area), but is otherwise 
much the same as Basic II. 


To get rid of the window display (which 
is not a multi-tasking window anyway, 
and so cannot be re-sized), just enter a 
MODE command, and the screen will 
clear to the standard white-on-black 
display of a BBC micro. Because 65Tube is 
not trying to emulate the whole BBC 
micro environment, all RISC OS star 
commands are recognised (as they are 
simply passed to RISC OS), and likewise 
star commands specific to the BBC micro 
will be rejected. Thus you cannot check on 
sideways ROMs by typing *ROMs. You 
can only do this with the *ListROMs 
command, and this in turn is not a built-in 
feature of RISC OS. But loading 65Host 
first implements this command. 


65Tube is the emulator that should 
normally be used with any BBC ROMs. It 
makes much more memory available, and 
also gives access to all the screen modes of 
the Archimedes. For example, you could 
use View with a 132 column screen (mode 
24), but operation is then significantly 
slowed down. It is also the mode to use if 
you have ROM images on disc, However, 
these should be loaded as required to 
memory address &8000 using the *LOAD 
command (e.g. *LOAD View 8000), 
followed by *GO 8000 to enter the 
software. 


You can exit from 65Tube, as with 
65Host by typing *Quit. Similarly, once 
the 65Tube module has been loaded, you 
can re-invoke it at any time by typing 
*EmulateTube from the command line 
prompt. 


As stated at the outset, by no means 
all BBC micro software can be made to 
run with an emulator, but there is much 
that can. And don’t forget to explore the 
running of strictly Basic programs in 
native mode first - that’s always the best 
solution if it works. Finally, even if you 
were not previously a BBC micro owner, 
there is a lot of software around, often 
quite cheaply now, for that machine. If 
anything takes your fancy then an 
emulator may be what you need to get it 
working. The only category of software 
that nearly always fails is games! AW 
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16 BIT SCSI 


Winchesters and 


controller card for 
300/400/A3000. Exceptionally fast. Up to 


7 devices per card. Internal drives come 
with all necessary mounting hardware. 
External drives have their own PSU and 
fan.Please specify if for A3000. 


Internal (inc. card) External (inc. card) 


20Mb ~—s- £375.00 20Mb £535.00 
45Mb = £495.00 45Mb £655.00 
70Mb ~~ £895.00 70Mb ~— £1055.00 
135Mb £1595.00 90Mb  £1249.00 
180Mb £2065.00 135Mb £1625.00 
Card only£199.00 I70Mb  £1850.00 
A3000 Card £199.00 330Mb £2845.00 


BBC Winchesters available from £359.00 
p&p £15.00 winchesters, £8.00 card only 


- OAK 


Oak Computers, Cross Park House, 
Low Green, Rawdon, Leeds LS19 6HA 
Tel: 0532 502615 Fax: 0532 506868 
Also available from all good Acorn Dealers 


Worra Plotter 


HAPGL plotter driver 
to allow Drawfiles to be 

4 plotted to HPGL plotters. 
Output may be scaled and 


sent to ports, network or file. i : i @) 


All prices exclude VAT 


£29.95 (p&p £4.50) 


PDT 


Parametric wa 
Design Tool. The 
Professional | 
Computer 

Aided Design. 2D parametric design and 
modelling system allows designs to be 
tested, animated and easily modified 
before being output to an HPGL compatible 
plotter or via DXF files to other CAD 
systems or !Draw and then on to DTP etc. 


soo 


ET A te 


£359.00 p&p £6.00 


TAPE 
STREAMERS 


Available from mid-December, Oak SCSI 
Tape Streamers provide the ideal means 
of backing up data from SCSI or ST506 
winchesters, networks or indeed any filing 
system. Desktop software allows files for 
backing up to be easily specified, and 
data can be saved and restored ona file 
by file basis. Add £100 if you do not have 
a SCSI card. p&p £15.00 
60Mb (per tape) £999.95 
1S0Mb (per tape) £1254.00 


Worra Battle 


Classic Tank Battle 
Game. Voted best 
game at the Personal 
Computer Show by the Guardian. 3D 


g rf @} high speed vector graphics. 


£14.95 (p&p £4.50) 


A Desktop File-Find Utility —— 


by Lee Calcraft 


Ts multi-tasking application runs 
from the Desktop and allows you to find 
files and directories on any disc (or on 
Econet or the RAM filing system). It 
accepts wildcards, and will list the full 
path name for each find which it makes. 


Search for: 


Search front 


elie) Fea IB 


BGeSiiteans&.lFllering: gprs 
[0%] 


Pole Tadisitems tet i= 


fp OLCT —adfsccTrans9.s. Filerind Ts} 


Sprites !Runlnage 12 


re] 


"| 


It is run by double clicking on its icon 
from a directory viewer. This places a 
dialogue window on screen (see 
illustration). You should then click on the 
upper box and supply the name of the file 
or directory which you wish to search for. 
You may use the asterisk wildcard, as 
normal with filing operations. Thus Info* 
would search for both Info and Inform 
(case is ignored), while * on its own will 
match all names. Now press Return or 
click on the lower box and enter a starting 
point for the search. The program 
automatically supplies a default of the 
root directory of the disc containing the 
application itself, and you may edit this in 
any way. For example, if you add: 

TextFiles 
then the search will descend the directory 
tree starting at the $.TextFiles directory. 
Now click on Files to search for matching 
filenames, or Directories to search for 
matching directory names - or click on 
both. Then to start the search, either click 
on OK or press Return. 


When searching is complete, or when 
more than 200 finds have been made, a 
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second window will appear, displaying the 
results. Matching directory names will 
appear in blue, while matching filenames 
are given in black. 


If you are searching floppies, you can 
set the starting point to :0 (or more 
properly ADFS::0) and insert one disc 
after another in succession until you have 
found what you are looking for, just 
clicking OK (or pressing Return) each 
time, without the need to mount each disc. 
This provides a very fast and effective way 
to find a lost file from a large pile of discs. 


In order to keep the program relatively 
simple (and fast), no attempt has been 
made to multi-task during the search 
process itself. A typical floppy search will 
take just a few seconds, but if you are 
searching a 20 Mbyte hard disc, the 
program will take a minute or so. To enable 
you to halt a search at any time, the 
Escape key is enabled during searching, 
and will cause finds made before the key 
was pressed to appear as normal. 


SETTING UP THE PROGRAM 
First create a suitable application 
directory, sprite and !Run file by running 
the Application Shell Generator from 
RISC User Volume 3 Issue 2. You should 
supply an application name of !FileFind 
together with a suitable path. For example: 
:0,!FileFind 
or 
ADFS: :HardDisc. !FileFind 
and answer “Y” when asked if a !Run 
Obey file is required. 


| !Run Obey file for !FileFind 
WimpSlot -min 32K -max 32K 


Set FileFind$Dir <Obey$Dir> 
Run <FileFind$Dir>. !RunImage 


Suitable !Run file for the FileFind 
application 


Finally, type in the program listed here 
and save it in the newly created 
application directory under the name 
!RunImage, and the job is done. 
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10 REM >§. !FileFind. !RunImage 
20 REM Program >WimpFindA 
30 REM Version A 0.9A 


40 REM Author Lee Calcraft 
50 REM RISC User April 1990 
60 REM Program Subject to Copyright 


80 DIM dirnameS &100,target% 100 

90 DIM block$ &200,result% 100 

100 max%=200 

110 DIM find$(max%) , type% (max%) 

120 DIM text% 255,text1% 12 

130 cdir$=FNdefault 

140 root$=LEFTS (cdir$, INSTR(cdir$,"$") 


150 $text%=root$:$text1%="" 

160 reason%=-1; files%=FALSE 

170 dirs%=FALSE:finds%=0 

180 quit%=FALSE:$block%="TASK" 

190 SYS "Wimp Initialise",200, !block%, 
"FileFind" TO version%, task 

200 ON ERROR PROCerror:END 

210 PROCcreatewinds 

220 block%!0=wlhandles 

230 SYS "Wimp _GetWindowState", , block’ 

240 SYS "Wimp OpenWindow",, block’ 

250 ON ERROR IF FNwimperror THEN END 

260 REPEAT 

270 PROCpoll 

280 UNTIL quit% 

290 Sblock%="TASK" 

300 SYS "Wimp CloseDown", task%, !block’ 

310 END 

320 : 

330 DEFPROCpol1 

340 oldreason%=reason% 

350 SYS "Wimp Poll”,1,block% TO reason 
% 

360 CASE reason% OF 

370 WHEN 1;PROCredraw 

380 WHEN 2:SYS "Wimp OpenWindow", , bi 
ock$ 

390 WHEN 3:PROCclose 

400 WHEN 6:PROCmouse 

410 WHEN 8:PROCkey 

420 WHEN 17,18:IF block%!16=0 THEN q 
uit%=TRUE 

430 ENDCASE 

440 ENDPROC 

450: 
460 DEFPROCclose 

470 window%=blocks!0 

480 CASE window’ OF 

490 WHEN wlhandle$:quit%=TRUE 

500 WHEN w2handle%:SYS "Wimp CloseWi 
ndow", ,block$ 

510 ENDCASE 


520 ENDPROC 

530 : 

540 DEFPROCkey 

550 IF block$!24=13 AND block%!0=wlhan 
dle% THEN 

560 CASE TRUE OF 

570 WHEN block%!4=i0handle%:PROCse 
tearet 

580 WHEN block%!4=ilhandle%:PROCst 
art 

590 OTHERWISE SYS "Wimp _ProcessKey 
",block$!24 

600 ENDCASE 

610 ELSE SYS "Wimp ProcessKey", block’ 
24 

620 ENDIF 

630 ENDPROC 

640: 

650 DEFPROCsetcaret 

660 SYS "Wimp_SetCaretPosition", wlhand 
le%, ilhandle%, , ,-1, LEN (Stext%) 

670 ENDPROC 

680 : 

690 DEFPROCmouse 

700 IF block%!12=wlhandle% AND (block% 
!8=4 OR block$!8=1) THEN 

710 CASE block%!16 OF 

720 WHEN i2handle%:filest=NOT file 
st 

730 WHEN i3handle%:dirs%=NOT dirs% 

740 WHEN i4handle%:PROCstart 

750 ENDCASE 

760 ENDIF 

770 ENDPROC 

780 : 

790 DEFPROCstart 

800 IF dirs%=FALSE AND files%=FALSE TH 
EN ERROR 254,"Please set FILES or DIRECT 
ORIES or both” 

810 block%!0=wlhandle%:block%!4=i0hand 


820 SYS "Wimp GetIconState", , block’ 
830 target $=$ (block%!28) 

840 block%!4=ilhandle% 

850 SYS "Wimp GetIconState", , block’ 
(block$!28) 

findS()="" 

880 IF path$="" THEN path$="$" 

890 *FX 229 

900 SYS "Hourglass On" 

910 PROCsearch (path$) 

920 SYS "Hourglass Off" 

930 *FX 229,1 

940 *FX 124 

950 PROCforce 

960 SOUND 1,-8,70,4 

970 ENDPROC 
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980 : 
990 DEFPROCforce 

1000 w2yext%=finds$*32+200 

1010 IF w2yext%<400 THEN w2yext%=400 

1020 block%!0=0:block$! 4=-w2yext 

1030 blocks! 8=w2xext%:blockt!12=0 

1040 SYS "Wimp _SetExtent", w2handle%, blo 
cké 

1050 block%!0=w2handle& 

1060 SYS "Wimp_GetWindowState", , block’ 

1070 SYS "Wimp_OpenWindow", , block’ 

1080 minx=block%!4:miny=block%!8 

1090 maxx=block%!12:maxy=block%!16 

1100 SYS "Wimp ForceRedraw",-1,minx,min 
y,maxx,maxy 

1110 block$! 

1120 4handles 

1130 sblock$!12=2°21 

1140 SYS "Wimp_SetIconState", , block’ 

1150 ENDPROC 

1160 : 

1170 DEFPROCcreatewinds 

1180 REM x,y,width, height, extx%,exty% 

1190 REM extx% & exty% are hidden parts 

1200 wlx%=500:wly%=350 

1210 title$="File Finder" 

1220 w2xext%=2500: w2yext%=2500 

1230 wlhandle%=FNcreate (50, 600, w1x%, wly 
%, 0,0, &A700000F, title$) 

1240 w2handle%=FNcreate (600,500, 600, 400 
yw2xext$-600, w2yext%-400, &FFOOOOOF, "FIND 
8") 

1250 iOhandle%=FNicon (wlhandle%, 240,-10 
0,220, 64, &F535,8,0,"", text1%,-1, 11) 

1260 ilhandle%=FNicon (wlhandle%, 32,-230 
428, 64, 6F535,8,0,"", texts, -1, 255) 

1270 i2handle%=FNicon (wlhandle$%, 32,-320 
, 100, 64, &B43D, 8,0,"Files",0,0,0) 

1280 i3handle%=FNicon (wlhandle%, 166, -32 
0, 200, 64, &B43D, 8,0, "Directories", 0,0, 0) 

1290 i4handle%=FNicon (wlhandle%, 400, -32 
0, 64, 64, 6B43D, 8, 0, "0K", 0,0, 0) 

1300 ENDPROC 

1310: 

1320 DEFFNicon (whandle%, ix%, iy%, iw%, ih 
,flag%, feol%, bcol%, text$, d1%,d2%,d3%) 

1330 block%!0=whandle& 

1340 block’! 4=ix%:block%!8=iy% 

1350 block$!12=ix%+iwS:block$!16=iy$+ih 
& 

1360 block%!20=flag%+ (£col%<<24) + (bcol% 
<<28) 

1370 IF dl%=0 THEN 

1380 $(block%+24)=text$ 

1390 ELSE 

1400 block%!24=d1% 

1410 block$!28=d2% 


RISC User April 1990 


1420 block$!32=d3% 

1430 ENDIF 

1440 SYS "Wimp_CreateIcon",, block’ TO i 
handle’ 

1450 =ihandlet 

1460 : 

1470 DEFFNcreate (vwx%, vwy%, vww%, Vwh%, ex 
tx%, exty%, flags%, title$) 

1480 Sblock%=STRINGS (88, CHRSO) :REM Clr 


1490 REM Visible Work Area 

1500 block’! 0=vwx% :REM xl 
1510 block’! 4=vwy% :REM yl 
1520 block’! 8=vwxt+vww% :REM x2 
1530 block$!1 ly $+vwh% +REM y2 


1540 block$!2 :REM no winds above 
1550 block$!28=flags%:REM wndow flg 
1560 REM Window Colours 

1570 block%?32=7 :REM Title fgnd 

1580 block%?33=2 :REM Title bcg 

1590 block%?3 :REM Work area colour 
1600 block%?3: :REM Work area beg 
1610 block%?3 :REM Scroll bar beg 
1620 block$?3) :REM Scroll bar fgnd 
1630 block%?38=12 :REM Title bar hight 
1640 REM Work Area Extent 

1650 block%!40=0 :REM WAE x1 
1660 block$!44=-vwh%-exty% :REM WAE yl 
1670 block$!48=vww%textx% :REM WAE x2 
1680 block$!5: :REM WAE y2 
1690 block%!56=&3D:REM Title icon flags 
1700 block%!60=3<<12:REM Work area flgs 
1710 $(block%+72)=title$ 

1720 SYS "Wimp CreateWindow",,block® TO 
handle’ 

1730 =handle% 

1740 : 

1750 DEFFNdefault 

1760 LOCAL name’, result% 

1770 DIM name% 30, result% &100 

1780 Sname%="FileFind$Dir" 

1790 SYS "OS_ReadVarVal", name%, result’, 
&100,0,3 TO ,,dlen% 

1800 result%? (dlen%+1)=13 

1810 =$results 

1820 : 

1830 DEFPROCredraw 

1840 window$=block’!0 

1850 SYS "Wimp RedrawWindow",,block% TO 
mores 

1860 PROCgetorigin (block%, x0%, y0%) 

1870 WHILE more’ 

1880 IF window%=wlhandle% THEN PROCdr 
awl (x0%,y0%) ELSE PROCdraw2 (x0%, y0%) 
1890 SYS "Wimp GetRectangle",, blocks 
TO mores 

1900 ENDWHILE 

1910 ENDPROC 
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einer 
POSSIBLY THE ONLY pl 


DRAUGHTING SYSTEM 
YOU WILL EVER 
NEED 


Created specifically for the Archimedes, DESIGNER INTRO is based 
onitsbig brother DeSial 


@) 


a 


FEATURES 


COST EFFECTIVE CAD 


Fully menu driven with simple 
prompts and instructions for all 
foutines. 

User definable grid with grid lock. 


Hunt and lock onto nearest end of 
ling, arc or centre of a arc/circle 


Important for engineering 
applications. Nine i-bult arc types 
alone. 


Ellipses, full or part. 


Powerful delete facilities, ¢.., last 
Item. line, part line, arc, part arc, etc. 
software automatically finds 

Intersections.) 


Unique MODIFY command allows 
Grawingtoberedrawnalineatatine 
forwards or backwards. The drawing 
may be ‘entered’ at any point thus 
giving total flexibility to edit and 
alter drawings. 

‘Automatic or manual dimensioning, 
User definable arrow heads/leader 
lines. 

Text entry at any size, angle or slope. 


(Text output limited only by the 
plotter available.) 


No practical limit to the number of 
drawing elements that may be 
creat 


Comprehensive transformation 
commands, MOVE, ROTATE. 
MIRROR IMAGE, ALTER SIZE. 


‘created. Library items can then be 
incorporated into the current 
‘drawing at any size, angle, position, 
Zoom, scale and pan facilities (plot- 
‘outs may be taken at any time). 


Output to wide range of line plotters 
from Sto A0,e.9., Graphtec, Hewlett 
Packard, Hitachi, Plotmate, Roland, 
etc. Plus screen dumps for 
FA/MX/RX compatible printers, 


COST EFFECTIVE CAD FOR 
YOUR ARCHIMEDES 
In creating INTRO TechSoft have 
kept the features that made 

INER (BBC) s0 popular. There 
'showever one feature that we have 
Cut back on - the cost. INTRO is not 
attoy (although you will enjoy playing 
with it, itis a true working system 
ata realistic price. 


P.S. f your draughting requirements 


Hatching at any angle/spacing. 

Automatleally inds enclosed ae cen 

boundary plussingle or multiple (ARCHIMEDES), mors than a match 

islands. for any drawing 

Powerful ELEMENT (layer) parepbienal’s 

eum Please remember that TechSoft can 
supply a wide range of CAD related 


peripherals and accessories, e.g, 
plotters, plotter pens, etc. 
Ch 

ue with order please, Ne 
toTecnsotUKLig 
Add VAT @ 15% of total. (Official 
educational orders welcome.) 


LE 
Pie 


mK 


with a single button press. No practical lei to the size ‘of ee 
drawing created - limited only by 

True arcs, tangents and normals, 

essentials for most drawing ak wpace, 

applications but particularly Libraries of drawings can easily be \ 


TechSoft UK Ltd. 
ony £79 var. sane 
(OVERSEAS £95) NEW IDEAS IN SOFTWARE Sa'0sas18° 


A Desktop File-Find Utility 


1920 : 

1930 DEFPROCgetorigin(block%, RETURN x0% 
RETURN y0%) 

1940 x0%=block$!4-block%! 20 

1950 y0%=block%!16-block$!24 

1960 ENDPROC 

1970 : 

1980 DEFPROCdraw2 (x0%, y0%) 

1990 tabt=x0%+32 

2000 MOVE tab%, y0%-56 

2010 SYS "Wimp_SetColour", 11 

2020 PRINT"Finds: ";finds%; 

2030 IF finds%=max% THEN PRINT" (overfl 
ow)" 

2040 IF finds’>0 THEN 

2050 FOR n%=0 TO finds%-1 

2060 MOVE tab%, y0%-100-32*n% 

2070 SYS "Wimp SetColour", 6+type%( 
ns 

2080 PRINT find$ (n%) 

2090 NEXT 

2100 ENDIF 

2110 ENDPROC 

2120 : 

2130 DEFPROCdrawl (x0%, y0%) 

2140 SYS "Wimp SetColour",11 

2150 MOVE x0%+32, y08-56 

2160 PRINT "Search for:" 

2170 MOVE x0%+32, y0%-120 

2180 PRINT"Search from:" 

2190 ENDPROC 

2200 : 

2210 DEFPROCclose 

2220 $block$="TASK" 

2230 SYS "Wimp _CloseDown", task%, !block’ 
2240 ENDPROC 

2250 : 

2260 DEFPROCerror 

2270 ON ERROR OFF 

2280 $block%="TASK" 

2290 SYS"Wimp_CloseDown", task%, !block% 
2300 PRINT REPORTS$;" at line ";ERL 
2310 ENDPROC 

2320 : 

2330 DEFFNwimperror 

2340 *FX 229,1 

2350 *FX 124 

2360 !blockt=ERR:mess$="" 

2370 IF ERR<>254 AND ERR<>17 THEN mess$ 
="at line "+STRSERL 

2380 $(block$+4)=REPORT$+mess$+CHRSO 
2390 SYS "Wimp ReportError", block’, 3,"T 
est Window" TO , response? 

2400 IF response%=2 THEN 

2410 Sblock%="TASK" 

2420 SYS "Wimp CloseDown", task%, !bloc 
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2430 ELSE 

2440 PROCforce 

2450 ENDIF 

2460 =response%=2 

2470: 

2480 DEFPROCsearch (path$) 

2490 LOCAL next’ 

2500 next%=0 

2510 REPEAT 

2520 $dirname$=path$ 

2530 $target %=target$ 

2540 SYS "OS _GBPB",10,dirname%, result 
%,1,next%,100,target% TO ,,,objects%,nex 
tt 

2550 IF objects%>0 THEN 

2560 type%=result$?16 

2570 a%=20:result$="" 

2580 REPEAT 


2590 ct=result?at 

2600 IF c%<>0 THEN result$+=CARS ( 
c%) 

2610 ast=1 


2620 UNTIL, c%=0 

2630 IF finds%<max% AND ((type%=2 A 
ND dirs%=TRUE) OR (type%=1 AND files%=TR 
UE)) THEN 


2640 find$ (£inds%)=path$+", "+resu 
1t$ 

2650 type’ (finds%) =type% 

2660 finds$+=1 

2670 ENDIF 

2680 ENDIF 


2690 UNTIL next%<0 

2700 next%=0 

2710 REPEAT 

2720 $dirnamet=path$:Starget%="*" 
2730 SYS "OS _GBPB", 10, dirname’, result 
%,1,next%,100,target% TO ,,,objects%,nex 


2740 IF objects%>0 THEN 
2750 type%=result%?16 
2760 a%=20:result$="" 
2770 REPEAT 


2780 ce=result$?at% 

2790 IF c%<>0 THEN result$+=CHR$ ( 
c& 

2800 aSt=1 


2810 - UNTIL c%=0 
2820 IF type$=2 THEN 


2830 PROCsearch (path$+"."+result$ 

) 

2840 ENDIF 

2850 ENDIF 

2860 UNTIL next%<0 - 
2870 ENDPROC AY 
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MORLEY &..-£-C-T-R-0-N-1-C-SIOS® 


— 

See ae 
alld 
THE WORLDS MOST POWERFUL MICRO 


A3000 £649 410/1 £1199 
310 £899 420/1 £1699 
310M £959 440/1 £2499 


SPECIAL OFFER UNTIL JANUARY 1990 

BUY AN A3000 OR ACORNS DESKTOP 

PUBLISHER AND SAVE 20% OFF THE 
COST OF A MORLEY RAM BOARD 


THE A3000 OPTION ACORN FORGOT 


QO Easy to install simply plug in Q Includes full fitting kit and 
and run instructions 


THE BEST VALUE MEMORY UPGRADES 


Q Easy to install simply plug in 
and run 


(Filly compatbte with all Acorn 


software including desktop 
publisher 

A must for ail serious 
Archimedes owners 

Make full use of Acorn's 
powerful Desk-Top Publishing 
package 


(CD) 1.Neg upgrade gives you a total 
of 2 Meg on-board 


(1 Meg board upgradeable to 3 
Meg 


ARCHIMEDES PERIPHERALS 


Colour Monitor £220 
Mono Monitor £73 
Printer Lead £9 
3000 

Monitor stand £29 
User port & MIDI Podule £49 
Serial Upgrade £19 
Econet Upgrade £49 
Pipedream 3 £147 
Risc Os Companion £49 
1st Word + £69 
Autodesk CAD £79 
Acorn PC Emulator £99 


1 Meg Upgrade £150 
3 Meg Upgrade £415 
1 Meg to 3 Meg £298 
305 1/2 Meg £105 
400 Series 1 Meg £145 
400 Series 3 Meg £395 
300/400 series 

Acorn Rom Podule £56 
2 Slot Backplane £37 
4 Slot Backplane £59 
VO Podule £80 
Midi Podule £65 
20 Meg Hard Disc & 

Controller £465 
Acorn DeskTop Pub. £149 
Clares Pro Artisan £145 
Clares Artisan £29 
Clares Toolkit £34 
Clares Toolkit + £43 


C High quality Japanese Drive Dual Drive Kit £125 
LEADS & MISC. HARDWARE ETC. 

‘Arch Monitor Leads: Printer Stand 80 col £15 
SCART £8 Printer Stand 135 col £19 
9 Way 'D' (Msync) £8 Tilt. & Swivel Monitor 

Arch Serial Lead £8 Stand ett 
Arch Printer Lead £6 Monitor Stand/plinth 

BEG Printer Lead £6 BBC £13 
2 to 1 Printer switch £20 Master £14 
3 to-l Printer switch £30 BBC/Master SCSI 

4 to 1 Printer switch £36 Hard Disc Intertace £50 
84k Printer Buffer e115 Eprom Eraser £18 
256k Printer buffer £199 Eraser with timer £23 


(NOTE switching units & print buffers come with printer lead) 


The Morley TELETEXT 
ADAPTER is now available for 
the Archimedes. The specifica- 
tion including screen dumps etc.. 
is the same as the BBC version 
but connection is via a Podule 
socket. £125 


EXISTING USERS OF QUA BBC 

TELETEXT ADAPTER 

WE CAN UPGRADE THE UNIT 

FOR THE ARCHIMEDES FOR 
£35 


RING FOR DETAILS 


‘We are now an Acorn dealer and 
service centre. If you would like to 


hava a look at the A3000 or any 
other Acomn/Morlay products 
please fool free to call in and 
discuss your requirements with 
our statf. 


COMING SOON 
Morley Module Podule 


‘Atows requantly required Modules’ to be 

loaded into a non-volatile storage area on 
‘aving the tedium of 
your des for the 


Kit includes: 5.25" Teac 80 track drive; case; power supply; 
3.5" drive cradle; interface and leads 69 


A3000 SCSIPODULE £149 
A3000 WINCHESTERS 


Including SCSI Podule, drive, case and leads 


20meg£465 30 meg £495 
40 meg £575, 60-200 meg POA 


TO ORDER... 


CARRIAGE: £1 on all orders. £3 on larger. BY PHONE: By quoting your ACCESS or 
iterts (adapters) VISA card number 

im ‘Goods usualy daspatchod by tetuin 
Government and Education orders 
weicome, 


VAT- UK cusiomers pleace add 15% 10 
cost incl. carriage. 

BY POST: Enclose cheque made payable 
fo MORLEY ELECTRONICS LTD. 


Morley House, Off Norham Road, North Shields, Tyne & Wear NE29 7TY. Tel: (091) 257 6355. Fax: (091) 257 6373 


DFS Filing System for the Archimedes 


Alan Wrigley examines a piece of software which bridges the gap 


between the Arc and the Beeb. 


B ack in the early days of the BBC micro, 
the default filing system was cassette. Users 
would switch on their machine and then sit 
back for ten minutes while the latest 
game failed to load from their cassette 
recorder. After a while, the Disc Filing 
System (DFS) became available, and 
gradually people began to realise that for 
any serious computing, a disc drive was 
essential. Some loved the DFS, some who 
had experienced other disc filing systems [6 
were not so sure, but at any rate it was 
better than cassette! 


Along came the Master 128, boasting 
the newer Advanced Disc Filing System 
(ADFS), but also retaining the DFS for 
compatibility with earlier models. Many 
users welcomed the new features of 
ADFS, but almost as many preferred to 
stick with the trusty old DFS. With the 
advent of the Master Compact, DFS 
lovers now had to load their favourite 
filing system from disc as it was no 
longer resident in the machine, and finally 
the Archimedes broke with the tradition 
completely by offering no facilities for DFS 
whatsoever. 


As a result, Archimedes owners who 
have upgraded from a BBC often have a 
large number of programs and files which 
they would like to use but cannot do so 
easily. Various solutions have been sought, 
for example programs which can read a DFS 
disc, such as BEEBUG’s DFS Reader, or 
serial links between a BBC and an Arc 
(which are of no use to those who have sold 
their BBCs). But until now, no attempt has 
been made to provide a complete DFS 
environment on the Archimedes. ArcDFS is 
set to change all that. 


The software comes on a single disc. 
Double-clicking on the directory viewer icon 
installs a module called ‘DFS’, and a row of 
grey disc drive icons appear on the left of 
the icon bar, in addition to the more normal 
red and cream ADFS icons. The new icons 
are numbered in the usual DFS format, in 
other words, each side is treated asa 
separate drive. So if, for example, you have 
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‘MaveGen 


a single drive there will be two grey icons 
labelled :0 and :2, as well as the ADFS icon 
labelled :0 as usual. 
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viewers open, and the DFS menu structure 
shown above drive 0. 


ArcDFS will be of most use to owners 
who have one or more 5.25” drives 
connected via an external interface, such as 
the BEEBUG Archimedes Disc Buffer, and 
so there will be two grey icons for each of 
these drives. It can get a little difficult 
keeping track of all these drives - rather 
confusingly, drive 2 (DFS) is the reverse side 
of drive 0, whereas drive 2 (ADFS) is the 
whole of the second external drive, i.e. 
drives 4 & 6 (DFS). Just to make matters 
worse, if you have a hard disc fitted, this 
will be drive 4 (ADFS)! Confused? Well, it is 
all quite logical when you understand it. I 
must point out that this is not the fault of 
ArcDFS, but rather the way in which Acorn 
decided to configure its filing systems. 


Once the system is installed it is a 
delight to use. You can select DFS or ADFS 
on any drive simply by clicking on the 
appropriate icon. Directory viewers can be 
opened for any DFS drive in just the same 
way as for ADFS. Files can be manipulated, 
ive. by dragging, deleting, renaming etc., and 
can be saved from, and loaded to, RISC OS 
applications, and they can be read and 
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written to from within programs, using 
OPENIN and OPENOUT for example. It is 
also a simple matter to transfer files from 
DFS to ADFS by dragging the icon from one 
window to the other. 


ArcDFS can be used quite happily with 
the BBC emulators 65Host and 65Tube, 
allowing you to use software which expects 
to find a DFS system in operation and may 
use DFS-specific commands. 


SOFTWARE FUNCTIONS 
Clicking the menu button over a DFS 
drive icon brings up a menu of options. With 
one exception, this is identical to the menu 
obtained by clicking on an ADFS drive icon, 
allowing you to dismount, format, backup, or 
verify a disc, or to display the amount of free 
space. The ADFS Name disc option, however, 
is now included in a sub-menu which is 
headed Misc, and which also includes 
Protect and Unprotect, which respectively 
remove or restore write access to the disc, 
and also Swap Cats, which allows you to 
access the second catalogue of a double 
catalogue disc, as created with Disc Doctor 
or Advanced Disc Toolkit. A Quit option 
removes all the DFS icons from the icon bar. 


ArcDFS also supports a number of star 
commands. These cover all the normal 
commands you would expect to find on a 
DFS system, such as *Backup, *Drive, 
*Title, *Verify etc. (but not *Compact), as 
well as all the functions mentioned above 
which are accessible from the Desktop. 
There are also, however, star commands to 
turn automatic sensing of double density 
discs on and off, and to manipulate disc 
sectors. ArcDFS does not contain a sector 
editor as such, but it does have commands 
for dumping sectors to the screen, and 
loading and saving them to and from 
memory, enabling you to edit the data 
yourself and then restore it to the disc. 


Formatting options are very 
comprehensive. In addition to a choice 
between 40 and 80-track formatting, as you 
would expect, the software can also handle 
Acorn (single density), Solidisk (double 
density) or Watford (single or double) format. 
When you select Watford, you can also choose 
standard or large size catalogues (i.e. 31 or 
62 entries). Double density gives you 320K 


(Solidisk) or 360K (Watford) per side on an 
80-track disc, but of course you cannot use 
such discs on a standard Acorn DFS system. 


It is also possible, using a supplementary 
application supplied, to create a DFS 
partition on an ADFS disc, which can be 
either a floppy disc or a hard disc. This 
consists of a single 200K file containing an 
entire DFS disc, and would enable you, for 
example, to hold three DFS ‘discs’ on one 
ADFS floppy, or create an area on a hard 
disc to hold a selection of heavily-used DFS 
utilities. You can also create similar files in 
memory using the *RamDisc command, 
which works in a similar way to the RAMFS 
in RISC OS, but is controlled by the DFS. 


CONCLUSIONS 

With such a wealth of features on offer, 
it is difficult to.escape the conclusion that, if 
you still have DFS files, and you are using 
or planning to use an external drive with 
your Archimedes, this is one piece of 
software that you would find extremely 
useful. The only faults I could find were 
minor ones. For example, it is not possible 
to transfer files from a DFS disc to an ADFS 
disc on the same drive, which is a pity if you 
only have one floppy in your machine. 
However, this will affect only a very small 
minority of users who have a 3.5” drive and 
a model B. Finally, a very small gripe, but 
one that programmers should realise will 
annoy users: the *Copy command takes over 
the abbreviation *Co. which many people 
already use for *Configure. 


I can strongly recommend ArcDFS, and I 
feel sure there will be a lot of Are users who 
wish it had been around in the early days of 
the machine. However, if you only wish to 
transfer DFS files across to ADFS, a DFS 
reader will do the job perfectly well at a third 
of the price. Nor should my enthusiasm be 
taken as a recommendation to use DFS as the 
preferred filing system; ADFS is the native 
filing system on the Archimedes, and has a 
great many advantages over its predecessor. 


ArcDFS 

Dabs Press 

5 Victoria Lane, 

Whitefield, 

Manchester M25 6AL. 

Tel. (061) 766 8423 fe) 
£29.95 inc. VAT. aU 


Product 
Supplier 


Price 
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Multi-column Program Listings 


Doug Tuddenham presents a utility for listing Basic programs ona 
printer with a selectable number of columns. 


The program is supplied on this month’s 
magazine disc only. 


In RISC User Volume 2 Issue 5, David 
Spencer described how to detokenise Basic 
programs, and how to produce screen 
listings of Basic files on disc. The program 
presented here is a development of this, 
enabling a simple star command to produce 
multi-column hard copy listings of a Basic 
program, held either on disc or in memory, 
without affecting the latter. 


The listing is printed a page at a time, in 
condensed print, and all columns on a page 
are of equal length. Spacing between 
columns is one character, but this is 
effectively increased by inserting leading 
spaces into line numbers below 10,000. All 
DEF PROC and DEF FN names are 
highlighted, and are also preceded by blank 
lines regardless of any included in the 
listing. These lines consist of a single colon 
but this can be changed by altering line 
3360 of the source program. Assembler 


INVOICING & ACCOUNTS 


New: V3 of The Account Book now available. 
Comprehensive small business accounts to trial 
balance. VAT approved. Absolutely the easiest 

program to use, with neat final books and hundreds 
of reports. No entry limits. "The Account Book gets 
first prize for both price and performance"- 
comparison in Micro User-July "89. A true user - 
friendly program. It succeeds admirably "-Beebug - 
Oct '88. And that was Version 2, V3 has many new 
features. £27.95. 

New: V2 The Invoice Program. Database, Invoices 
(unpaid and paid), Statements (individual and 
automatic), Stock presets, Debtor lists, Linking with 
The Account Book and loads more £27.95. 
You will not be disapointed!!-See review BEEBUG 
Dec'89, 


Apricote Studios 
2 Purls Bridge Farm 
Manea 
Cambs 
PE15 OND 
Tel: 035 478 432 for information, help or to order. 


labels are also highlighted, irrespective of 
their line position, but are not preceded by 
blank lines. 


The program on the magazine disc is the 
Basic source code, which assembles the 
machine code utility when run. The latter 
should be saved to disc in the Library 
directory (which should be created if it does 
not already exist). The utility is invoked by 
typing: 

*PCol <columns> <filename> [P] 

The maximum number of columns is 9; if 
this parameter is omitted, the default of 3 is 
used. Omitting the filename causes the 
program in memory to be printed. The P 
option provides a pause facility, enabling 
discs to be swapped if the program to be 
listed is filed on another disc. 


The default values in lines 120-160 can 
be altered to suit your requirements. In 
particular, C% is the number of columns, 
and W% the page width (condensed print). 

AW 


PROFESSIONAL 
Tools#] =— 10 F280". Manse, 
Tools#2. = 2 
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AuloMount 


WatfordDi 
Magnifier 


Paintl6 « 
Paint 256 


Macro Assembler © 


DemoDise 


G.M.A.mbH Wandsbeker Chaussee 58 
2000 Hamburg 76 West Germany 
Tel.: 01049-40-2512415, Fax.: 01049-40-2502660 
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& ROBICO ADVENTURES 


FOR THE ARCHIMEDES 


J. G. is a 36 years old accountant, who is used to analysing complicated statistics and taking 
informed decisions, conscious of the risks involved. His is a high profile, high stress 
occupation... 


D. K. is a 36 years old schoolmaster, serving as Head of Chemistry in a large comprehensive 
school. His heavy teaching and administrative duties can, at times, make his a high pressure 
position .. . 


D. B. is a 13 years old Australian schoolboy; apart from his studies and his sporting activities, 
he enjoys a pretty carefree existence .. . 


O. H. is in his early twenties and is a Norwegian medical student. His long and arduous 
studies do not allow him much spare time .. . 


B. L. is a professional Knitwear designer, who specialises in writing knitting patterns. 
Imagination, flair, CAD and DTP, combined with up front marketing responsibilities, add up to 
one hectic life. . . 


B, G. is a housewife and Age Concern Visitor. Fully involved in community affairs, she knows 
that her free time is too precious to waste... 


M. E. is a 17 years old sixth former studying for his A-levels; unpaid and overworked, he 
rarely has time to relax... 


These are simply a few of the interesting people who spend a proportion of their leisure 
hours in playing a Robico adventure. They appreciate the atmospheric text, the different 
scenarios, the wit and humour, the intricate puzzles and the evocative situations. Good 
adventures transcend class and enrich and stimulate the mind. 


So, in order to introduce the diverse pleasures of adventure gaming to an even wider 
public, we are making you an offer you cannot refuse! Buy any one of our Archimedes 
adventures direct from us @ £29.95, and if you don't enjoy it, you can return it to us, in 
prime condition, within 21 days and get a £29.00 refund. (We keep the other 95p to 
cover post/pack and administration costs.) 


Choose from STRANDED!, RISE IN CRIME, FUGITIVE'S QUEST 
and ENTHAR SEVEN. 


(See previous Robico advertisements for game scenarios.) 


Don't delay: Order Today: What have you got fo lose? 


Robico Adventures are available from all good computer stores or direct from 
ROBICO, 3 FAIRLAND CLOSE, LLANTRISANT, MID GLAM CF7 8QH Tel. (0443) 227354 


Please make your cheque payable to 'Robico' 
or you may pay using your ACCESS card. 


by Lee Calcraft 


= form a vital part of any Wimp 
system, as the acronym itself suggests 
(Wimp means Windows, Icons, Menus and 
Pointers). Yet we have not even touched 
on them thus far. In Acorn’s Wimp system, 
the icon is a powerful and flexible 
component. It is so flexible in fact that 
Acorn have some trouble in pinning it 
down in their own documentation. It is 
defined in the PRM simply as a 
rectangular area of a window’s workspace, 
and can contain a sprite, or text or a 
combination of both - or indeed, anything 
else which the programmer requires. 


The sprites appearing in directory 
viewers on the Desktop are all icons, but 
icons can take many other forms. Each 
item in a Wimp menu is also an icon, In 
this case, the icons are usually text only or 
text plus a sprite (in the case of a ticked 
option). Each icon can also behave in a 
wide variety of different ways: it might be 
reversed out when selected, greyed out 
when not selectable, it might return double 
clicks to its application, or it might be what 
is termed a writeable icon. This means that 
you can type text into it, and edit the 
result. The permutations are endless, and 
each must be defined by setting the 
appropriate flags in calls to the Wimp. 


SYS “Wimp_CreateIcon” 

Icons are always associated with a 
parent window, and each window can have 
many icons within it. Each icon has an 
icon handle unique within its own window 
(issued by the Wimp in incrementing 
values from zero), so that the window and 
icon handles together uniquely define the 
icon. 


Icons can be created using the call 
Wimp_CreateIcon (SWI &400C2). This is 
analogous to the call used to create a 
window (Wimp_CreateWindow). In a 
similar way it informs the Wimp about the 
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Part 7 - Icons: the groundwork 


icon, and supplies all the flags necessary 
to define it completely, but it does not 
display it on the screen. This only occurs 
when the parent window or the icon itself 
is updated. 


Typically the parent window would be 
created, then all its icons, then the 
window would be opened (using a call to 
Wimp_OpenWindow), and finally the 
window and its icons would be drawn 
during the first cycles of the Wimp Poll, as 
described earlier in the series. Icons can of 
course be altered, or indeed created, at 
later stages in the process as we shall see 
in due course. But for now we will take a 
closer look at the process of creating icons 
prior to the opening of the parent window. 


R1 Pointer to parameter block 


R1+0 Handle of window (or -2 for left of 
icon bar, -1 for right) 

Min x coord of icon bounding box 
Min y coord of icon bounding box 
Max x coord of icon bounding box 
Max y coord of icon bounding box 
Icon flags 

12 bytes of icon data 


R144 
R1+8 
R1+12 
R1+16 
R1+20 
R1+24 


The call returns the icon handle in RO 


Figure 1. Parameters used with 
Wimp_Createicon (SWI &400C2). 


This is all performed using 
Wimp_Createlcon, and the parameter 
block for this call is given in figure 1. The 
four co-ordinates are all measured relative 
to the work area origin. This is normally 
the top left-hand corner of the work area, 


, so the y co-ordinates of the icon bounding 


box are measured downwards and will 
both be negative, with the more negative 
of the two being first - see figure 2. 


The 32 bits of icon flag data are 
elucidated in figure 3. If you have been 
following this series, most of the items 
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visible 


area 


Figure 2. The 4 co-ordinates used in the 
Wimp_Createlcon parameter block, 
with example values 


will be reasonably obvious. But three 
terms call for comment. The reference to 
indirection (bit 8) means that instead of 
giving the text content of the icon (or its 
name if a sprite) within the parameter 
block (at R1+24 of figure 1), the parameter 
block holds a pointer to an area of RAM. 
This permits text of more than 12 
characters in length to be used in an icon, 
and also allows the creation of icons 
containing text and a sprite. Additionally, 
indirection must be used in cases where 
the content of the icon is liable to change 
(such as with writeable icons), and in 
other special cases. We will deal with 
writeable icons in the next issue. 


The second point needing clarification is 
the notion of a so-called exclusive selection 
group or ESG (bits 10 and 16-20). The 
Wimp allows you to nominate groups of 
icons which behave interactively. For 
example, you might have a feature which 
could take 3 possible values (thus volume 
might be high, low or off). In such a case 
icons representing the three states could be 
placed in the same ESG by giving them the 
same ESG number (any number between 1 
and 31). Each time one of the buttons is 
selected, the Wimp will automatically 
deselect all other icons in the same group. 


Any icon with an ESG of zero on the other 
hand will behave independently of all 
others. Again we will take a closer look at 
this feature in a forthcoming issue. 


it 
0 
+ 
2 
3 
4 
5 
6 
r¢ 
8 
9 
0 


Meaning when set 
Icon contains text 
Icon contains a sprite 
Icon has a border 
Contents centred horizontally 
Contents centred vertically 
Icon has filled background 
Text is anti-aliased 
Icon requires task’s help for redraw 
Icon data is indirected 
Text is right justified 
If selected with Adjust don’t cancel 
others in same ESG 
Display sprite at half size 
Icon button type 
Exclusive selection group (ESG) 
Icon is (already) selected 
Icon is not selectable (is shaded) 
Icon has been deleted 
Foreground colour (if bit 6=0) 
Background colour (if bit 6=0) 
Alias font handle (if bit 6=1) 


Figure 3. Icon flags used with 
Wimp_Createlcon SWI &400C2. 


Finally the icon button type: this is a 
number between 0 and 15 (see figure 4) 
which specifies how the icon will affect, 
and be affected by, the pointer. It works in 
a very similar way to the work area flags 
treated in part 3 of the series. 


ICON FLAG GENERATOR 
Because of the complexity of deriving 
valid icon flags, the program in listing 1 is 
supplied. This attempts to automate the 
process. If you run it, it first asks if you 
have a default set of flags (which you may 
wish to use as a template for a new set). If 
you just press Return at this point, the 
default option will be ignored. But if you 
supply a set of icon flags as a hex number, 
this will be used as a default in what follows. 


You will then be presented with each 
icon attribute, and will be asked to enter 
“y”, “N” or a numerical value where 
appropriate. By pressing Return on any 
item, you will enter the default from the 
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default string supplied at the start. At the 
end a hex value is displayed for the 
resultant set of flags. The only thing you 
will need to add to the final value is the 
font handle (bits 24-31) if anti-alias fonts 
are used. 


Effect 


Ignore the mouse and pointer 

Notify task continuously while pointer is over icon 

Click notifies task (auto repeat) 

Click notifies task (once only) 

Click selects icon; release over icon notifies task; 
moving pointer away deselects. 

Click selects; double click notifies task 

As 3 but can also drag 

As 4 but can also drag (moving away doesn't 
deselect) 

As 5 but can also drag 

Pointer over icon selects; moving away deselects; 

click over icon notifies task (for menus) 

Click returns button state*256; drag returns button 
state*16; double click returns button state*1 

Click selects, and returns button state*1; drag 
returns button state*16 (for radio buttons) 

Reserved 

Click causes icon to gain caret, and parent 
window to gain input focus (writeable icons); 
can also drag 

Click causes icon to gain caret, and parent 

window to gain input focus (writeable icons) 


Figure 4. Icon button types 


INITIAL EXPERIMENTS 

There are a good number of features 
involved in icon creation that we have not 
yet covered, but there is just one which 
needs mentioning before we can go ahead 
and put some icons on the screen. We have 
not said anything very concrete about the 
12 byte block at R1+24 of the 
Wimp_Createlcon parameter block (figure 1). 
In many cases this will contain pointers to 
text strings and sprite names. But in the 
simplest case it will just contain the name 
of a sprite or a short string of text to be 


displayed within the icon. The maximum... 


length of this is 12 characters, and if it is 
less than 12 it must be terminated by a 
control character (ASCII 0-31). 


With the formalities out of the way we 
will look at some real examples. These 
make use of the function FNcreateicon. To 
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follow the experiments, you will need to 
insert a number of lines into the test 
program given in part 1 of this series. The 
function definition given in listing 2 
should first be appended to the end of the 
program (using the APPEND <filename> 
command, which automatically renumbers 
the incoming segment). It takes 10 
parameters as follows: the first is the 
handle of the parent window; the next 4 
are the x and y co-ordinates of the bottom 
left-hand corner of the icon, and its width 
and height. Next come the icon flags, and 
the text string (or name of the sprite). 
Finally there are three 32 bit words used 
when the data is indirected. 


Highlighted icon trom test program 


To test out the function, insert the 
following line into the main body of the 
program: 

225 ilhandle%=FNicon (whandle%, 32,-150, 
100, 48, &800B43D, “Icon1",0,0,0) 
If you now run the program you should 
see that the familiar window now boasts a 
bordered text icon containing the word 
“Iconl1”, and that clicking on it will 
alternately select and deselect it. When 
selected its colours will be reversed. Now 
feed the icon flag value (&800B43D) into 
the icon flag generator program, and 
adjust it in any way you like, and test the 
results in the Wimp test program. For 
example, try changing the flags for 
boundary box, filled background, right- 
justification, text and background colours 
etc; and try altering the position of the 
icon within the host window’s work area. 


Next month we will continue with this topic, 
looking at how to obtain data about the state 
of a particular icon, how to create writeable 
icons, and how to use indirected data. 
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Archimedes memory upgrades 
A310 expanded to 2Mb - £375 A310 expanded to 4Mb - £595 


These fully guaranteed boards (CJE which are simply not available with only 
Micro’s) combine with the existing RAM —_1Mb. A305 computers can also be fitted 


in the machine to give a total of either with these memory boards, although they 
2 or 4Mb. The extra memory is must be upgraded to the full 1Mb first. 
functionally identical to that in a 400 Prices include VAT, fitting (2-3 day 
series machine, and offers facilities turn around) and carriage. 

* For the A305 and A310 AVAILABLE NOW 


* Compact, single-board design - no messy ribbon cable 
%* 2Mb version can be upgraded to 4Mb later 
* Price includes VAT, fitting and overnight courier collection/delivery of your machine 


Write or phone for our free illustrated leaflet. 


A3000 extra 1Mb (2Mb total) £140 
RAM for 400/11 series POA, approx £99 per Mb IFEL 


45Mb internal SCSI hard disc system (Oak) £550 

4-slot multi-layer backplane + fan (305/310) £69.95 36 Upland Drive 
Impression £155 Derriford 
Prices inclusive of VAT Plymouth 
Write or phone for our free current price list (0752) 847286 | m| PL6 6BD 


"FIRST" 
ADVANCED STATISTICAL SYSTEM 


For Acorn Archimedes; BBC Models B, B+ and Master; “Industry Standard" machines 
A powerful and practical tool for Research, Industry, Business, and Teaching 


Integrated, interactive, robust, fast, accurate, modular. Designed to facilitate data critique. 

Many data entry options. Full data management and formatted display. Extensive data transforms. 
Handles missing values and data subsets. Scatterplots, regression plots, function plots. 
Univariate statistics. Paired and unpaired t tests. Chisquare tests. Nonparametric methods. 
Unrivalled REGRESSION facilities eg weighted, through the origin, standardised. Full statistical information. 


Residuals, fitted and predicted values. Much more. Correlations. ANOVA. Contour plots of regressions. 
Regression DIAGNOSTICS - VIFs, influential points etc. Automatic warnings. 
ROBUST regression - many influence functions. Powerful NONLINEAR least squares 
Time Series, eg moving averages, exponential smoothing, causal models. 
One- Two- and Three-way ANOVA subsystems. Distributions generator. Histograms. Linear Calibration. 
Ciuster analysis. Many other powerful analytical and descriptive features. Full utilities. 


Price £120-£180 (machine and version dependent). Special RISC USER discount available. 


There's far too much to describe here. Get full information now from: 
Serious Statistical Software, Lynwood, Benty Heath Lane, Willaston, South Wirral L64 1SD Tel. 051 327 4268 
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Listing 1 
10 REM >$. !Wimps.IconFlag2 
20 REM Program Icon Flag Gen 
30 REM Version A 0.02 
40 REM Author Lee Calcraft 
50 REM RISC User April 1990 
60 REM Program ‘Subject to Copyright 


80 MODE12 

90 flag%=0 

100 PRINT"WIMP ICON FLAG GENERATOR" 

110 PRINT'"Generates 32-bit icon flag 
for use with Wimp CreateIcon"' 

120 INPUT "Default value (or Return) & 
"default$ 

130 PRINT'"Respond with Y (=YES) Ret ( 
=Copy) or any other key (=NO)" 

140 PRINT"to questions below about the 
window you are creating"' 

150 IF default$="" THEN 

160 e%=FALSE 

170 ELSE d%=EVAL ("&"+default$) :e%=TRUE 

180 ENDIF 

190 REPEAT 

200 READ A%,A$ 

210 IF A%<255 THEN 

220 IF e% THEN 

230 d$="N":IF (d% AND (1<<A%))>0 T 
HEN d$="y" 

240 ELSE d$="_"" 

250 ENDIF 

260 PRINTA$;" (bit ";A%;")";TAB(55); 
d$;TAB(60) "Y/N 2? "; 

270 B%=GET AND &DF 

280 IF B%=13 THEN 

290 BS=- (d$="Y") 

300 ELSE B%=-(B%=ASC"Y") 

310 ENDIF 

320 IF B%=1 THEN PRINT"Y" ELSE PRINT 
on" 

330 = flagt+=B%<<A% 

340 IF A%=6 THEN bit6%=B% 

350 ENDIF 

360 UNTIL A%=255 

370 PRINT'"The following options need 
decimal input (or Return to copy)" 

380 READ A$, G%,BS$ 

390 shift%=0 

400 WHILE A$<>"2" AND NOT(shift%=16 AN 
D bit6%=1) 

410 shift%=VAL (LEFT$ (AS, 2) 

420 IF e% THEN 

430 . de%=(d%>>>shift%) AND (2*G%-1) 

440 ELSE det=0 

450 ENDIF 

460 PRINT BS;" (bits ";A$;")";TAB(55 
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)sde%;: INPUT TAB(60) ;C$ 

470 IF C$="" THEN 

480 Ct=det 

490 ELSE C%=VAL C$ 

500 ENDIF 

510 = flag$+=(C%<<shift%) 

520 READ A$,G%,BS 

530 ENDWHILE 

540 PRINT'"Icon flag= &";~flag% 

550 END 

560 : 
570 DATA 0,Contains text 

580 DATA 1,Icon is a sprite 

590 DATA 2,Icon has border 

600 DATA 3,Horizontally centred 

610 DATA 4,Vertically centred 

620 DATA 5,Filled background 

630 DATA 6,Text is anti-aliased 

640 DATA 7,Needs task to redraw icon 

650 DATA 8,Icon data is indirected 

660 DATA 9,Text is right justified 

670 DATA 10,If selected with Adjust ke 
ep ESG 

680 DATA 11,Display sprite if any at h 
alf size 

690 DATA 21,Icon (already) selected 

700 DATA 22,Icon not selectable (shade 
d) 

710 DATA 23,Icon has been deleted, 255, 

720 DATA 12-15,4,Icon button type 

730 DATA 16-20,5,Exclusive selection g 
roup no 

740 DATA 24-27,4,Foreground colour 

750 DATA 28-31, 4,Background colour, 2,0 
1 


Listing 2 
10 REM >$.!Wimps.!Wimp7.FnIcon 
20: 
30 DEFFNicon(whandle%, ix%,iy%,iw%, in’ 
flag’, text$, d1%,d2%,d3% 
40 block’! 0=whandle% 
50 block%!4=ix%:block$! 8=iy% 
60 block$!12=ixs+iws 
10 block$!16=iy%+ih% 
80 block%!20=flagt 
90 IF di%=0 THEN 
100 $(block%+24)=text$ 
110 ELSE 
120  block%!24=d1%:block%!28=d2& 
130 block%!32=d3% 
140 ENDIF 
150 SYS "Wimp CreateIcon",,block% TO i 
handle& 
160 =ihandle% AW 
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Using Draw Files in Basic (continued from page 11) 


52 


1720 DEF PROCPath_GetDetails (p%) 
1730 LOCAL ends’ 

1740 Path_fcols=!p% 

1750 Path_lcol%=p3!4 

1760 Path_thick%=(p%!8) *ObjMod_fac 
1770 ends%=(p%!12) 

1780 ?0bjMod_cj%=ends% AND 3 

1790 ObjMod_cj%?1=(ends%>>2 AND 3) 
1800 ObjMod_cj%?2=(ends%>>4 AND 3) 
1810 ObjMod_c}%?3=0 

1820 ObjMod_cj%! 4=«30000 

1830 ObjMod_cj%!8=(ends%>>16) <<4 
1840 ObjMod_cj%!10=(ends%>>24) <<4 
1850 ObjMod_cj!12=0bjMod_cj8!8 
1860 Path_strst%=p%+16 

1870 IF ends%>>7 AND 1 THEN 

1880 Path_pat%=Path_strst% 

1890 Path_strst%=Path_strst%+ (Path_pa 
t5!4+2)*4 

1900 ELSE 

1910 Path _pat%=0 

1920 ENDIF 

1930 IF (ends%>>6) AND 1 THEN Path wind 
$=632 ELSE Path_wind=630 

1940 ENDPROC 


Listing 2 

10 REM > RUDraw.DRAWPATHS 

20 *SET RUDraw$Dir $.RUDraw 

30 LIBRARY "<RUDraw$Dir>.DrawLib" 

40 MODE 12 

50 PROCObjMod_Setup 

60 filet=FNFile_Load("<RUDraw$Dir>.dr 
awfile", b%) 


DVS PUBLIC DOMAIN 


All discs have lots of extras 

#1, Logo Sprite Edge Detector, 167 World Flags, interactive 
Clares Wire Frame City, Buygones, Trendy Scroller, 
Mandelbrots, Graphics Quickies. 

#2. Garfield, O&X's, Nim Game, Battleships, PRESTEL Tasker, 
30 Maestro Tunes, Metric Converter, Car Race, Calendar Print. 

#3, Hangman, Connect Four, CD Quality Smooth Criminal, 2 Screen 
Compactors, Sprite Masking Utility, VDU test. 

#4, 3D Turning Skull, Breakout, Zap Revolving Graphics, Arcade 
Pairs Game, File Compare Util, Text Dumper. 

+#5. Simple Simon, Gold Touch Graphics, Snake Game, More Maestros, 
4d Edit, Buygones 2, Planet info, Key Board Test. 

#6, Fast Neonic Sign Writer, MicroMessages Scrolling Package, 
CHR$ editor, STD code finder/sort, Card Sharks, Graphics 
Quickies. 

***€2 Each or £11 for all Six*™* 
*Cheques to DVS Public Domain* 
140 Ravenhurst Drive, Birmingham, B43 7RS 


70 IF files THEN 

80 areat=file3+28 

90 Objt=files+44 

100 WHILE Obj%<>0 

110 PROCOb}_Display (0bj%, area’, 0) 
120 0bj%=FNOb}_Next (file’, 0bj%) 
130  ENDWHILE 

140 PROCBuf_Scrap(file%-4) 

150 ENDIF 

160 END 


Listing 3 

10 REM > RUDraw.LISTALL 

20 *SET RUDraw$Dir $.RUDraw 

30 LIBRARY "<RUDraw$Dir>.DrawLib" 

40 MODE 12 

50 PROCObjMod_Setup 

60 file%=FNFile Load("<RUDraw$Dir>.dr 
awfile",b%) 

70 IF fileS THEN 

80 areat=file%+28 

90 Obj%=files+44 

100 count $=0 

110 WHILE Obj%<>0 

120 count$+=1 

130 PRINT; count%;"_"; 

140 PROCOb}_ Info (Obj) 

150 0bj%=FNObj_Next (file%, 0b3%) 

160 ENDWHILE 

170 -PRINT"Total of ";count%;" object 


180 PROCBuf_Scrap(file%-4) 
190 ENDIF i 
200 END FW 


Sandie the Walrus Public Domain 
Presents PD Disc #1 


14 RISC OS Applications 
1st Word+ file conversion, Sticky Backdrop, 
Scientific calculator, Battleships, Solitare, Fish, Scrolly 
msg, Eyes, Application Creator etc. 
12 System font files 
5 SoundTracker & Maestro tunes 


U.LM. Character Editor 
Your financial worries are over - Warp to the network 

of your choice 

Computer Virus Killer 

Image Processor, Films & much much more 
Only £4.99 for 800K's worth!! 
‘Send cheques/PO to; 
Alexander Goh, STWPD, 12 Mornington Road, 
Radlett, Herts WD7 7BL. (UK) 
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Reviewed by Mike Williams 


I looked forward with some eagerness to 
reading and reviewing this book. For some 
time now newcomers to Archimedes 
computing have been asking if there is a book 
which will help them understand how to use 
their new machine. Now, the answer can be a 
welcome ‘Yes’. Yet I fear the end result is less 
than perfect. However, I feel that this reflects 
the undoubted difficulty of writing any book 
for beginners which will deal adequately with 
the immensely rich environment of RISC OS, 
the Desktop and other software which is 
supplied as part of the system. 


At 240 pages for just £9.95, Archimedes 
First Steps is certainly good value for money. 
The book is divided into 20 chapters with 
three appendices and a reasonable index. 
The first chapter is devoted to the Desktop 
environment, followed by an overview of the 
Applications discs, disc usage in general, and 
filing systems. This provides a most useful 
introduction to the Archimedes, but there 
are some weaknesses. For example, the 
reader is advised to use the Modules 
directory from Applications disc 1 by way of 
example: this is actually on disc 2 (the 
illustration in the book confirms this). There 
are also references which are not explained, 
such as quitting from an application, and the 
relevance of Arthur. 


These are small points, but illustrate the 
difficulty of presenting so much detail in a 
meaningful and coherent way. Other 
examples similar to those quoted occur at 
other points through the book. 


There are three chapters devoted to Edit, 
Draw and Paint with good and detailed 
examples which should help most users with 
these applications. A further chapter on 
Maestro, however, is really too short to add 
much to what is in the RISC OS User Guide. 


The chapters on customising the 
Archimedes and the use of the Task Manager 
are welcome and reasonably comprehensive, 
though I would have thought the pages of 
detail covering the *CONFIGURE command 
would have been better placed in an 
appendix. The short chapter on the RAM 
filing system is excellent, as I feel newcomers 
often overlook the benefits of this, 
particularly on single floppy disc systems. 
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Archimedes First Steps —_— 


The book continues with a number of 
relatively short chapters covering RISC OS, 
Basic V, modules, emulators and printers. In 
my view all of the information on Basic and 
much of that on RISC OS (which is 
relatively technical in nature) would have 
been better omitted, or expanded ina 
further book aimed unequivocally at 
programmers. On the other hand, the 
chapter on printers and the use of printer 
drivers deals at some length with what you 
need to know in this area. 


The last three chapters are intended to 
provide the new Archimedes user with some 
perspective on software and hardware 
products, and on potential sources of 
information and support (and this includes 
a mention for RISC User). Information on 
software is patchy to say the least, with 
nothing at all on databases or 
communications, and a definite bias in 
favour of other Dabs products. A list of the 
main software houses and their products 
might be more useful than longer 
descriptions of just a few. As far as 
hardware is concerned, the information is 
either confusing or simply vague, “If you 
want to fit an external disc drive, you will 
also need to buy a socket kit to fit a socket 
at the back of the machine”! There is also no 
information on the differing hardware 
expansion facilities of the A3000. 


There is an interesting appendix on 
Shareware for the Archimedes, otherwise 
known as Public Domain software, and the 
usual Dabs Press appendix listing most of 
their other products. 


CONCLUSIONS 

As I said at the outset, and alluded to 
elsewhere, the task that the author of this 
book has set herself is a difficult one indeed, 
and overall I feel it has not been achieved as 
well as might have been the case with more 
rigorous editing. However, at just £9.95 
there is still more than enough in this book 
to justify its purchase, and there is no 
alternative. My advice, if the Archimedes is 
still something of a puzzle to you, is to buy it 
as soon as possible. 


Archimedes First Steps by Anne Rooney, 


published by Dabs Press at £9.95. AU 
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* Full feature word processing * Full capability DTP * Multiple documents in memory * Multiple 
windows on each document * Any scale view from 1%-900% * Automatic hyphenation 
* Built-in spelling checker * Spell check as-you-type * Full 24- 
bit RGB, CMYK & HSV colour control * Fast character 
mode printing * 300K free workspace on a 1Mbyte 
machine * Supplied with 13 outline fonts © 
Flowing graphics with text * Automatic 
index generation * Automatic contents 
generation * Automatic abbreviation 
expansion * Automatic file conversion 
from other WPs © Virtual memory 
system - unlimited document size 
* Simple to use - only 5 main menus 
* Word count * Scaled printing * 
portrait & landscape pages in one 
document * active master pages 
* thumbnail printing * rotated 
printing * left/right only printing 
* pamphlet printing * collated 
printing * pause between pages * 
cut/copy/paste between documents 
* multiple master pages * fully 
a 
programmable key short cuts * 
overlaying styles * styles can be 
applied to any part of a paragraph 
* dynamic memory usage * search 
& replace for styles and codes 
* search & replace with wildcards 
* case-sensitive search & replace * 
auto-page numbering * roman 
numbering option * page 
numbering start at any value * 
multi-line headers & footers * 
graphics in headers and footers * 
graphics on/off options for screen 
& print * style merge from other 
documents © style — template 
documents * condensed & 
expanded text ® lefi, centre, right 
and decimal tabs * each style can 
have its own nuler * single & double 
underline options * text strikeout 
* underline colour control * rule- 
offs * hyphenation control on 
individual words © hyphenation 
exception dictionaries . 
programmable tab leader characters 
* intemal accuracy to 1/72,000ths 
inch * horizontal and vertical 
kerning to 1/1000ths em * text 
flow around frame control (both 
sides, either side or neither side) © 
guide frames * controllable frame 
snap * embedded graphics frames 
in text * embedded graphics on the 
line * go to page & chapter * two 
guess-misspelt-word options * word 
anagram solutions * crossword solving 
facilities * 8 user dictionaries © auto-load 
user dictionaries on start-up * user dictionaries 
compatible with Spellmaster * all measurements can 
be specified as inches, millimetres, centimetres, meters, points, 
feet, yards or picas * abbreviation expansion as you type * word 


substitution as you type * insert current date & time options ® controllable preferences for n 
units & default scale views © character mode printer drivers for Epson & LaserJet print | 


]M. PRESSION 


If other programs can offer all these features, 
then they might be as good as Impression. 


Computer Concepts Ltd 


Gaddesden Place 
Hemel Hempstead 
Herts HP2 6EX 
Tel. 0442 63933 
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COPY OPTIONS IN THE DESKTOP 
Alan Wrigley 


If you are copying files by using the *Copy 
command from the command line, you may 
know that there are a number of options 
available which affect the way the copy 
operation is carried out. For example: 

*Copy Dirl.MyFile Dir2.YourFile F V 
which copies the file MyFile from directory 
Dir1 to directory Dir2 and renames the new 
version YourFile, uses the F(orce) option to 
force an existing object of the same name to 
be overwritten, and the V(erbose) option to 
print information on each file copied. For 
more information on these options, see your 
User Guide. A list of the current option 
status can be seen by typing: 

*Show Copy$Options 
from the command line. A tilde character (~) 
before any option shows it is currently 
turned off, otherwise it is on. 


When copying files from the Desktop by 
dragging icons from one directory viewer to 
another, however, only the Force, Access and 
Stamp options have any effect (Force is 
described above, Access sets the destination 
access to the same as the source, while 
Stamp will re-stamp any date-stamped files 
after copying), There are separate Confirm 
and Verbose options available from the 
Desktop by clicking Menu over a directory 
viewer. These apply to copy operations by 
dragging, and to file deletion from the 
Desktop, and will remain in force until 
explicitly reset, i.e. the settings will be 
unaffected by switching the machine off. 


DOUBLE INSURANCE 


Lee Calcraft 
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The useful command *RMensure can be used 
to check for the presence of a particular 
relocatable module, and then to issue a star 
command if it is not present. This is often 
used to load the module if it is not present, 
as in the following example: 

*RMensure ARMBasicEditor 0.01 RMload A 
RMbe 
The name of the module is ARMBasicEditor. 
The number 0.01 tells the operating system 


Hints & Tips 


that it should look for version 0.01 or higher 
of the editor, and if it is not present in the 
RMA, it will attempt to load it using the 
filename ARMbe. 


You can usefully add a second line to this 
statement to perform an action if the 
attempted load was unsuccessful: 

*RMensure ARMBasicEditor 0.01 RMload A 
RMbe 

*RMensure ARMBas.cEditor 0.01 ERROR 25 
5 No Basic editor found 
The effect of the second line is to generate an 
error if the editor could not be found. But 
you can perform other actions providing they 
can be initiated by star commands, 


Note that in the error statement there is a 
space between the error number and the 
error message. In the Basic equivalent of 
this a comma is used, and the error message 
must appear between quotation marks. 


L FORMAT DISCS 
Alan Wrigley 


If you are using an Archimedes to format 
discs which are to be used on a Master 128 
or Compact, it is all too easy to forget that 
these machines cannot read D or E format 
discs, so you must use L format. If you try to 
catalogue or verify a D or E format disc on a 
Master series computer, you will see nothing 
at all on the screen, not even an error 
message. This can be very puzzling when it 
happens for the first time! 


*SOUND 
Lee Calcraft 


The command *SOUND works in a similar 
way to the Basic SOUND statement, but 
differs in that it can be used from the star 
prompt, from machine code, or from an Obey 
file (which must consist solely of operating 


* system commands). 


What is less obvious is that the parameters 
supplied with the operating system version 
are slightly different from those used from 
Basic. For example: 

SOUND 1,-15,70,5 
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will produce a loud beep when executed from 
Basic, but the equivalent: 

*SOUND 1 -15 70 4 
will not generate any sound at all - you will 
just get the message Bad sound command 
parameter. Notice by the way that Basic’s 
commas have been replaced by spaces. 


The problem lies in the amplitude. In the 
Basic version, this takes values between -15 
(loud) and 0 (silent), while the operating 
system version uses the range &FFF1 (loud) 
to 0 (silent). Thus the equivalent of SOUND 
1,-15,70,4 is: 
*SOUND 1 &FFF1 70 4 

Note incidentally that both the Basic and the 
operating system versions of the SOUND 
statement permit the use of a logarithmic 
scale of amplitude not available on earlier 
BBC micros. See the SOUND section in the 
Basic User Guide. 


COPYING FROM THE SERIAL PORT 
Alan Wrigley 


Files can be copied to the serial port by using: 
*Copy <filename> Serial: 
However, trying to copy from the serial port 
using: 
*Copy Serial: <filename> 
does not work. This is because copying 
operations load the file before copying, but 
when reading from the serial port a byte at a 
time, there is no simple way for the 
operating system to know how long a file will 
be, so a normal load operation is impossible. 
There are two ways to copy files from the 
serial port, both of which require a short 
Basic program, as shown in the examples 
below. 


In each case, it is assumed that you are 
copying the file to a new file called MyFile. 
You must also have some means of knowing 
when the end of the file has been reached. If 
you are transferring from a BBC micro, for 
example, you can open the file, read the EXT 
value, and send this at the start to the 
receiving computer, which could then use a 
FOR-NEXT loop to read in the whole file 
byte by byte. Alternatively, as shown in the 
examples below, there may be an end-of-file 
marker in the file; on some systems it is 
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common to use a byte of value 4 (Ctrl-D) at 
the end of the file for this purpose. 


The first method of copying is to open the 
port as a file, and read the bytes one ata 
time as you would from a disc file, for 
example: 

10 X%=OPENOUT ("MyFile") 

20 Y%=OPENIN("Serial:") 

30 REPEAT At=BGET#YS 

40 BPUT#X%, A 

50 UNTIL A%=4 

60 CLOSE#0 


Secondly, you can divert the computer’s 
input stream to come from the serial port 
instead of the keyboard, and read each byte 
of the file as if it were typed in from the 
keyboard, as follows: 

10. X$=OPENOUT ("MyFile") 

20 *FX2,1 

30 REPEAT A&=GET 

40 BPUT#XS, AS 

50 UNTIL At=4 

60 *FX2,0 

70 CLOSE#X% 


OS_SerialOp1 PRM BUG 
Lee Calcraft 


There is a mistake in the specification of the 
bits set and returned with OS_SerialOp1 in 
the Programmer’s Reference Manual (page 
194). The specification for bit 2 should read 
as follows: 
Value Meaning 
0 1stop bit. 
1 2 stop bits in most cases. 
1 stop bit if 8 bit word with no parity. 
1.5 stop bits if 5 bit word with parity. 
The Serial Port Status Utility published last 
month interprets this call correctly. 


IST WORD PLUS WITHOUT SPELLCHECK 
Geoffrey Neil 


Contrary to statements made in a rival 
magazine, you can cancel the spelling checker 
option from 1st Word Plus Release 2, and 
recover the RAM released by the operation. 


To do this, select Spelling from the main 
menu, and End spell check from the Spelling 
sub-menu. Ru 
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USING THE DESKTOP IN MODE 16 
Many RISC OS users, including myself, have 
their Desktop environment set up so that the 
screen display is in mode 16. This gives 
nearly double the screen area in mode 12, 
and uses less memory than mode 15. This is 
ideal for word processing and graphics work 
because all the windows that need to be open 
at once can all be seen, instead of having to 
move them around as often happens with 
mode 12. 


However, not all multi-tasking packages 
work in this mode. For example, once Artisan 
2 has installed itself on the icon bar, the 
pointer is then restricted to half the Desktop, 
probably because a MOUSE RECTANGLE 
COMMAND has been used. A cure for this is 
to press F12 followed immediately by Return 
to start up the Desktop again. 


This is inconvenient, and companies like 
Clares (who produce Artisan 2) should 
thoroughly test their packages with all RISC 
OS features, and not rush to finish their 
product. 

S.R.Masefield 


RISC USER, LIFE, THE UNIVERSE ETC. 
In general, I am very satisfied with the 
service and magazine I receive. I refer to back 
copies very regularly, and its small page size 
and lack of excessive advertising makes it 
easy to store and find the articles I need. I 
find what advertising you do have useful 
and relevant, and I assume that they have a 
level of endorsement from you. I assume that 
the income provided is useful but it does not 
appear to be the raison d’etre for the 
magazine. 


I value your reviews as you have more scope 
for independence and you make use of it. I 
view with some alarm the increasing cost of 
programs both in money and in RAM. 
Minerva are an example, with the rococo 
decoration used in both Gammaplot and 
System Delta command screens which 
obscure rather than improve the application. 
Minerva’s documentation is awful. 

Bryan Hyde 


Mr Hyde included many comments and 
suggestions in his letter, and we have had to 
omit some of these for want of space. We 
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would also welcome reactions from other 
readers on any of these points. 


The magazine is not wholly dependent upon 
advertising, and could be produced with no 
advertising at all, but we do use some of the 
income from advertising to pay for additional 
editorial pages. This is one of the reasons why 
the number of pages in the magazine is not 
constant. However, advertisers receive no form 
of endorsement from us, though we always try 
and act responsibly where advertising is 
concerned. Our attitude to advertising means 
that reviews can, we hope, be quite fair and 
objective. 


Documentation is an area that frequently 
comes in for criticism, and sometimes quite 
deservedly so. Inevitably manuals become 
ever more extensive (for example, the 
excellent manual for Pipedream 3 from Colton 
Software which runs to over 400 pages) but 
this can only be achieved at a price. | also 
have been a critic of Minerva's documentation 
(referred to by Mr Hyde) in the past, but this 
has improved enormously from what it was. 


The price of software is another emotive 
subject. Users never want to pay what the 
product costs, while software houses always 
want to charge more than it's worth! The fair 
price probably lies somewhere in the middle. 
But is Archimedes software getting too 
expensive for what it is? Software houses 
clearly have to make a living, but who is to say 
what is a fair price? 


DOES THE A310 HAVE A FUTURE? 
When Acorn launched the Archimedes back 
in ‘87, I was going to buy an A305. But then 
I had second thoughts and decided to buy the 
full-feature (at that time) A310. I thought 
that with the extra half megabyte of RAM I 
would never get left behind. So I bought the 
A310 (which really dented my bank balance) 
thinking I wouldn’t have to splash out any 
more cash, I was annoyed enough when I 

~ had to pay more for RISC OS - but not 
wanting to be left out I paid the extra (along 
with everyone else). Then Acorn dropped the 
A300 series altogether. 


Now with the advent of the A3000, the 
A400/1 series, the ARM3, extra RAM etc. it 
seems as if us loyal early purchasers have 
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been stitched-up a treat, not being able to 
upgrade without spending yet more hundreds 
of pounds. And to rub salt into the wound, I 
now hear rumours about another improved 
version of RISC OS waiting in the wings, 
which will probably cost more than the 
previous one. 


So perhaps you can tell me, is an A310 with 
RISC OS still an acceptable Archimedes 
machine - after all, 2MByte software hasn't 
emerged yet. Or will I have to upgrade in 
order to keep pace with software 
developments? 

Kevin Gomm 


No doubt many RISC User readers sympathise 
with Mr.Gomm's views. However, we must 
separate areas where Acorn may legitimately 
be criticised for their actions, from what is 
reasonable commercial development for any 
company to undertake for its future viability. 
After all, manufacturers of all kinds continue to 
bring out new improved products, effectively 
downgrading older models (until they become 
classics). 


CHIMEDES 


First of all, an A310 with RISC OS is a more 
than acceptable Archimedes. It is probably the 
machine that the majority of readers have, it is 
what | have at home, and what we use here in 
the editorial office. That Acorn had to charge for 
RISC OS was regrettable, but | for one would 
not quibble for what we got in return. The one 
constraint which | believe to have been short- 
sighted was to limit the A310 to just 1MByte of 
memory, but even here third party suppliers, at 
a price of course, can provide increases to 2 or 
4MBytes. And more memory costs more money 
on every machine, although RAM chips are 
now much cheaper than they were. 


It is in the interests of all users that Acorn 
continues to improve and enhance its product 
line. It would be really quite silly if Acorn were 
not working on the next version of RISC OS 
(and the one after that). The danger is that 
poor decision making by Acorn in the past may 
unnecessarily appear to restrict existing users 
in the future. But for now, the A310 has an 
excellent working life ahead of it. ; 
Mike Willlams AU 


Disc 1EMACS. Super editor with language. Now includes full C source. 
Disc 2 MicroSpell. 43,000 word real time spelling checker module. 
Disc 4 XLISP. Object oriented version of LISP with C source and progs. 
Disc 5C Toolkit. 20+progs for C programmers with sources. grep, awk,.. 
Disc 6 Kermit. Archimedes, BBC and MSDOS versions of comms, prog. 
Disc 7 WIMP Chess. Good wimp based chess game with many features, 
Disc 8 CrossStar. wimp based crossword solver with huge dictionary. 
Disc 10 More C Tools. yacc and lex with examples and C source. diff etc. 
Disc 11 Little SmallTalk. original object oriented language with C source. 
Disc 14 GNU Tools#1. high quality tools with source. egrep,sed,awk, diff. 
Disc 15 Clip Art#1 50 pictures, also 65 Epson LQ printer fonts, !Sparkplug 
Disc 16 Spark. Super RISC OS wimp based multitasking file/directory 
archiver. !Backdrop sticky desktop, pd progs, 1Mb. colour pics. 
Disc 18 MTV Raytracer. database driven 3D raytracing package with C 
source code. Lots of fun making pretty raytraced pictures. 
Disc 19 Starchart. wimp multitask program to make Draw file starmaps 
showing positions of stars and planets. Catalog of 9000 stars. 
Disc 20 GNU Tools#2. gnumake. CXRF C source code cross ref. dbase. 


Xfmt simple nroff, pr formatter, M4 macro language. with C srcs. 
Each disc is £5.99 inc. Buy four claim another free! 
David Pilling, P.O. Box 22, Thornton Cleveleys, Blackpool. FY5 1LR. 


Free Air Mail delivery on overseas orders. _ Full list available on request. 
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USING LISTIF ON AN ARCHIMEDES 
When | spoke with you recently | said 
that LISTIF was not implemented on my 
A3000. You expressed surprise at this, 
but I have found the answer. 


On a Master 128 It Is permissible to omit 
the space between the line number and 
the first statement on the line, and then 
improve the appearance of the listing 
with LISTO7. On the A3000 though, the 
soft space Inserted by LISTO Is not 
recognised and LISTIF cannot 
distinguish the first word on the line 
(often the most significant). That is why | 
thought there was no LISTIF. | shall In 
future have to Insert hard spaces - 
tedious - a pity. There Is a bonus though: 
LVAR more than makes up for It. 

Derek Lucas 


In fact the position is not quite as Mr Lucas 
has described it, as there is no need to 
deliberately insert a space between a line 
number and the first entry on a line for 
LISTIF to recognise it. In this case just omit 
the space following LISTIF and separating it 
from the string being searched for. For 
example, if you want to search for all lines 
beginning with ‘DEF’, then enter: 

LISTIFDEF 
and it will still find those separated by one 
or more spaces. However, if you enter: 

LISTIF DEF 
then only those lines beginning with a space 
and then ‘DEF’ will be listed as Basic is 
searching for a four character string ‘ DEF’. 


RISC OS APPLICATIONS 
Can applications programs such as Edit, 
Draw, Maestro etc. (from the applications 
discs supplied with the Archimedes) be 
copied In their entirety? | have naturally 
made back-up copies of the two Acorn 
applications discs, but when | run a copy, 
such as Edit, | get a message that the 
support files are not found. 


In addition, !| still cannot see a way of 
printing .from Edit - am | missing 
something obvious? 

L.J.Colman 


When you open the directory viewer for 
Applications disc 1 there is one entry whose 
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function may not be immediately apparent, 
this is !System. If you open this application’s 
directory, by double clicking on its icon while 
pressing Shift, you will see that this contains 
a folder called Modules. Double click on this 
to open its directory viewer, and you will see 
that it contains three modules called CLib 
(the shared C library), Colours and 
FPEmulator (the floating point emulator), 
Many of the applications supplied on Acorn’s 
application discs need to use one or more of 
these resources. Because they are on the 
same applications disc, this happens 
automatically, unseen by the user. 


For example, Edit needs CLib, while Paint 
and Draw need this and Colours and 
FPEmulator as well. You can check this for 
yourself. Assuming that your machine has 
just been switched on (or you have pressed 
Ctrl-Break), press F12 and in response to the 
star prompt type: 
Modules 

This will scroll through the currently 
installed modules. At this point the last one 
on the list will probably be Podule. Now 
press Return to get back to the Desktop, and 
load any of Edit, Paint or Draw in the 
normal way (by double clicking on the 
relevant application icon). Now repeat the 
exercise above to list the installed modules, 
and you will see the additions at the end of 
the list. Note that Colours appears as 
ColourTrans and CLib appears as 
SharedCLibrary. 


As far as making a backup is concerned, 
provided that !System appears on the same 
disc as the application, loading the 
application as normal should cause no 
problems. In fact it is probably best to use 
*Backup to make a complete copy of each of 
the applications discs, and the discs will 
then have the same disc titles (Appsl and 
Apps2) as the originals. Mark your copies as 
current discs, and store the originals away 
safely. On a hard disc, you will need to copy 
all the files to a directory (could be the root 
directory). 


One word of warning: if you make copies of 
{System on various discs, then the first time 
that an application requires access to this 
resource, RISC OS will remember which disc 
this was on. If you subsequently load 
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another application from a different disc, 
even one which contains its own copy of 
!System, RISC OS will use the information it 
already has and ask you to re-insert the 
original disc. You are better off keeping only 
one working copy of !System. 


One final point: applications like Edit ete. 
check to see if the modules they require are 
already loaded before trying to locate 
!System. Thus, if you had already used, say, 
Draw, and then attempted to install Edit 
from another source (even one without a 
copy of !System) no difficulties would arise. 


As far as printing out Edit files is concerned, 
there should be no problems if you proceed 
as follows. Insert Applications disc 1 into a 
drive, open the directory viewer and double 
click on the !PrinterDM application (this is 
the printer driver for dot matrix printers). 


Once the application has installed itself on 
the icon bar, press Select over this icon to 
open a window, and use Select repeatedly 


until the relevant printer shows. Then close 
the window. Pressing the Menu button over 
the icon allows you to select parallel or serial 
printer (or a network printer, or output to a 
file). You can also save your choices so that 
in the future you only need to select the 
printer driver and install it on the icon bar. 


From then on, an Edit file can be printed by 
dragging its icon to the printer driver icon on 
the icon bar, and you can also do this within 
Edit by using the Save option. You may also 
be prompted to insert a disc (Applications 
disc 1) containing PrinterDM, as the printer 
driver sometimes needs to reference other 
files in this application directory. The printer 
driver will also call on Edit (in this case) to 
put the file into the format required by the 
printer driver. 

Mike Willlams 


NOTE: Colton Software has asked us to 
point out that Pipedream 3 can use the Acorn 
printer drivers as an alternative to its own 
(see last month’s Technical Queries). RU 
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Beebug Hardware Upgrades fo 


BEEBUG 
Hard Drives for the 400/1 series 


The BEEBUG internal hard disc upgrades use 
only high quality mechanisms from respected 
manufacturer's such as NEC, Rodime and Seagate. 
All our drives are easy to fit. 


Q All drives have an access time of less than 29ms 
9 40 & 53Mb drives feature autoparking 
© Full 12 months warranty 


a 53Mb drive uses the top of the range Rodime 
__ drive as used in the Archimedes 440/1 
O All drives fully tested and formatted prior to 
despatch 
Free fitting (by appointment) if brought to our 
" showroom 
~ Backed by the resources of Beebug 
Full fitting instructions included 
0120G Beebug A400 20Mb Drive 


0121G Beebug A400 40Mb Drive 
0122G Beebug A400 50Mb Drive 


BEEBUG 


A3000 Disc Buffer 


An exciting new release for the A3000 allowing 
the connection of 5.25" drives to the A3000. Some 
of the features include: 


o Connector for BBC-type 5.25" & 3.5" drives 
On board switches allow drive mapping to be 
changed. eg. The internal drive could be made 
drive 1, and an external drive as drive 0 - ideal 
for the PC emulator 

2 Whole interface contained on an internal card 
Easy to fit, supplied with full instructions 

— Will work with most drives that have an internal 

_ Power Supply Unit 

O Can read DFS files with optional DFS Reader 

5 Internal and external drives can be double 
stepped to read 40 track discs 
Full 12 months warranty 


0135C A3000 buffer 
0102B DFS reader 
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BEEBUG 
A3000 Memory Upgrades 


The BEEBUG A3000 memory upgrades are 
available in either 1 or 3 Mb versions and are easy 
to fit by the user, This will give a total of either 
2Mb or a massive 4Mb of memory. 


By using the latest surface mount technology we 
have achieved a board size of a mere 256x46 mm. 


The 1 Mb board can be easily upgraded to 3 Mb at 
any time by the user, unlike some other boards on 
the market. 


Q Easy to install with fitting instructions provided 
O Full 12 months warranty 

o 1 Mb expandable to 3Mb by the user 

O Uses latest surface mount technology 

9 Free fitting (by appointment) if required 


0130D Beebug A3000 Memory 1Mb £164.95 


0131D Beebug A3000 Memory 3Mb £399.95 
0132C 1Mb to 3Mb upgrade £250.95 


BEEBUG 
Archimedes 5.25" Disc Buffer MK II 


A high quality buffer mounted neatly and simply in 
the back a 300 or 400 series Archimedes. 

2 Almost any 5.25" drive with a PSU may be used 
Q Up to four drives (two external, two internal) 

a Full buffering of signal from computer 

 pIp switches allow re-mapping of drives 

0795C 5.25" Buffer (305/310/440) £33.25 


0784C 5.25" Buffer (400/1 series) £33.25 
0102B DFS reader & 9,90 


BEEBUG Serial Link Kit 


A fast, convenient method of transferring data 
between the BBC Micro/Master and the Arch. 
A3000 users will require the A3000 serial chips. 

‘Transfer in both directions 

wimp driven, easy to use software 

[ Compatible with both DFS and ADFS files 

& Includes software, 3m cable and instructions 
0796C Serial Link Kit 
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